From f5e048ea100f269629c7c2606bb756f1d7d93d2c Mon Sep 17 00:00:00 2001
From: Joshua Walls <josh.walls@outlook.com>
Date: Thu, 16 Jul 2026 12:50:59 -0400
Subject: [PATCH] release: v0.1.17

---
 RELEASE.md    |   5 +++
 manifest.json |   2 +-
 theme.css     | 116 ++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 122 insertions(+), 1 deletion(-)

diff --git a/RELEASE.md b/RELEASE.md
index 17a0921..b4cf95d 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -4,6 +4,11 @@ This file is for maintainers.
 
 ## Changelog
 
+### 0.1.17
+
+- Separated adjacent heading levels with clearer warm, cool, and neutral color changes.
+- Added a subtle depth indent for H3-H6 while keeping H1 and H2 flush.
+
 ### 0.1.16
 
 - Completed the H1/H2 underline swap by moving the full H2 rule to H1 and leaving H2 with the shorter trail underline.
diff --git a/manifest.json b/manifest.json
index e3514c1..f2831fc 100644
--- a/manifest.json
+++ b/manifest.json
@@ -1,6 +1,6 @@
 {
     "name": "Trailmark",
-    "version": "0.1.16",
+    "version": "0.1.17",
     "minAppVersion": "0.16.0",
     "author": "Joshua Walls"
 }
diff --git a/theme.css b/theme.css
index 5606633..0b255e3 100644
--- a/theme.css
+++ b/theme.css
@@ -5787,6 +5787,122 @@ body.is-mobile:not(.theme-dark):not([data-theme='dark']) .workspace-drawer-activ
   padding-bottom: 0;
 }
 
+/* Heading depth ramp: adjacent levels alternate color families and only h3-h6 step inward. */
+:is(#trailmark-heading-depth-ramp, .theme-dark, body[data-theme='dark']) {
+  --h1-color: var(--trailmark-harvest-orange);
+  --h2-color: var(--trailmark-seafoam);
+  --h3-color: var(--trailmark-fog);
+  --h4-color: var(--trailmark-campfire);
+  --h5-color: var(--trailmark-route-soft);
+  --h6-color: color-mix(in srgb, var(--trailmark-harvest-orange) 58%, var(--trailmark-dark-text-muted));
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-light, body[data-theme='light']) {
+  --h1-color: var(--trailmark-copper);
+  --h2-color: var(--trailmark-route);
+  --h3-color: var(--trailmark-trail-olive);
+  --h4-color: var(--trailmark-route-muted-base);
+  --h5-color: var(--trailmark-canyon);
+  --h6-color: var(--trailmark-light-text-muted);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h1,
+  .markdown-preview-view h1,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-1,
+  .markdown-source-view.mod-cm6 .cm-header-1
+) {
+  color: var(--h1-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h2,
+  .markdown-preview-view h2,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-2,
+  .markdown-source-view.mod-cm6 .cm-header-2
+) {
+  color: var(--h2-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h3,
+  .markdown-preview-view h3,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-3,
+  .markdown-source-view.mod-cm6 .cm-header-3
+) {
+  color: var(--h3-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h4,
+  .markdown-preview-view h4,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-4,
+  .markdown-source-view.mod-cm6 .cm-header-4
+) {
+  color: var(--h4-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h5,
+  .markdown-preview-view h5,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-5,
+  .markdown-source-view.mod-cm6 .cm-header-5
+) {
+  color: var(--h5-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h6,
+  .markdown-preview-view h6,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-6,
+  .markdown-source-view.mod-cm6 .cm-header-6
+) {
+  color: var(--h6-color);
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h1,
+  .markdown-preview-view h1,
+  .markdown-rendered h2,
+  .markdown-preview-view h2,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-1,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-2
+) {
+  padding-left: 0;
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h3,
+  .markdown-preview-view h3,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-3
+) {
+  padding-left: 0.28rem;
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h4,
+  .markdown-preview-view h4,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-4
+) {
+  padding-left: 0.5rem;
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h5,
+  .markdown-preview-view h5,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-5
+) {
+  padding-left: 0.72rem;
+}
+
+:is(#trailmark-heading-depth-ramp, .theme-dark, .theme-light) :is(
+  .markdown-rendered h6,
+  .markdown-preview-view h6,
+  .markdown-source-view.mod-cm6 .cm-line.HyperMD-header-6
+) {
+  padding-left: 0.94rem;
+}
+
 /* File explorer stability: active and hover cues must not change row width or folder text alignment. */
 :is(#trailmark-nav-stability, .theme-dark, .theme-light) .nav-files-container :is(
   .tree-item-self.nav-file-title,