Auto TOC: show when 6+ headings, suppress with toc: false

Author: OpenClaw Sync

_layouts/post.html

@@ -19,11 +19,18 @@ <h1>{{ page.title }}</h1>
     {% endif %}
   </header>
 
-  {% if page.toc %}
+  {% assign headings = content | split: '</h2>' %}
+  {% assign h2_count = 0 %}
+  {% for heading in headings %}
+    {% if heading contains '<h2 id="' %}
+      {% assign h2_count = h2_count | plus: 1 %}
+    {% endif %}
+  {% endfor %}
+  {% unless page.toc == false %}
+  {% if h2_count >= 6 %}
   <nav class="post-toc" aria-label="Table of contents">
     <p class="toc-label">Contents</p>
     <ul>
-    {% assign headings = content | split: '</h2>' %}
     {% for heading in headings %}
       {% if heading contains '<h2 id="' %}
         {% assign h2_part = heading | split: '<h2 id="' | last %}
@@ -35,6 +42,7 @@ <h1>{{ page.title }}</h1>
     </ul>
   </nav>
   {% endif %}
+  {% endunless %}
 
   <div class="post-content">
     {{ content }}

_posts/2026-03-11-nixclaw-declarative-ai-agents-on-nixos.md

@@ -1,7 +1,6 @@
 ---
 title: "NixClaw: Declarative AI Agents on NixOS"
 description: How I built a single-purpose NixOS VM that runs AI agents with their own git-backed workspaces, deployed in one command from a MacBook to Proxmox.
-toc: true
 ---
 
 I wanted AI agents I could spin up per-project, each with its own workspace and chat channel, running on infrastructure I control. A proper declarative system where the entire machine — disk layout, services, secrets, agent bindings — lives in version-controlled Nix.