From 0eb432700cc1a17d1eacda6882d3022e0ff90f83 Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Sun, 17 May 2026 13:55:10 +0200
Subject: [PATCH 1/7] Initial CLI page

---
 source/_components/nav-link.blade.php |   1 +
 source/_layouts/main.blade.php        |  16 +-
 source/cli.blade.php                  | 434 ++++++++++++++++++++++++++
 source/index.blade.php                |   7 +
 4 files changed, 451 insertions(+), 7 deletions(-)
 create mode 100644 source/_components/nav-link.blade.php
 create mode 100644 source/cli.blade.php

diff --git a/source/_components/nav-link.blade.php b/source/_components/nav-link.blade.php
new file mode 100644
index 0000000..686734c
--- /dev/null
+++ b/source/_components/nav-link.blade.php
@@ -0,0 +1 @@
+<a href="{{ $href }}" @class(['text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button', 'font-bold underline' => $active ?? false]) class="">{{ $slot }}</a>
\ No newline at end of file
diff --git a/source/_layouts/main.blade.php b/source/_layouts/main.blade.php
index c03b2ee..a8008b4 100644
--- a/source/_layouts/main.blade.php
+++ b/source/_layouts/main.blade.php
@@ -105,10 +105,11 @@ class="ignore-agent shadow-xl z-50 fixed bottom-3.5 right-3.5 border border-zinc
                 </a>
                 <nav class="relative flex items-center gap-6 text-sm  agent:flex-col agent:items-start">
                     <div class="hidden sm:flex items-center gap-6 agent:flex-col agent:flex agent:items-start agent:gap-3">
-                        <a href="/writers" class="text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Write content-md</a>
-                        <a href="/consumers" class="text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Read content-md</a>
-                        <a href="/specification" class="text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Specification</a>
-                        <a href="{{ $page->github }}" target="_blank" rel="noopener noreferrer" class="text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">
+                        <x-nav-link href="/cli" :active="$page->isActive('cli')" >CLI</x-nav-link>
+                        <x-nav-link href="/writers" :active="$page->isActive('writers')">Write</x-nav-link>
+                        <x-nav-link href="/consumers" :active="$page->isActive('consumers')">Read</x-nav-link>
+                        <x-nav-link href="/specification" :active="$page->isActive('specification')">Specification</x-nav-link>
+                        <a href="{{ $page->github }}" target="_blank" rel="noopener" class="text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">
                             GitHub ↗
                         </a>
                     </div>
@@ -116,9 +117,10 @@ class="ignore-agent shadow-xl z-50 fixed bottom-3.5 right-3.5 border border-zinc
                         <summary class="transition-button cursor-pointer">Menu</summary>
 
                         <div class="absolute w-60 bg-white dark:bg-zinc-950 shadow z-10 right-0 flex flex-col items-end gap-2 p-4">
-                            <a href="/writers" class="p-4 text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Write content-md</a>
-                            <a href="/consumers" class="p-4 text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Read content-md</a>
-                            <a href="/specification" class="p-4 text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">Specification</a>
+                            <x-nav-link href="/cli" :active="$page->isActive('cli')" >CLI</x-nav-link>
+                            <x-nav-link href="/writers" :active="$page->isActive('writers')">Write</x-nav-link>
+                            <x-nav-link href="/consumers" :active="$page->isActive('consumers')">Read</x-nav-link>
+                            <x-nav-link href="/specification" :active="$page->isActive('specification')">Specification</x-nav-link>
                             <a href="{{ $page->github }}" target="_blank" rel="noopener noreferrer" class="p-4 text-zinc-600 dark:text-zinc-300 hover:text-zinc-950 dark:hover:text-white transition-button">
                                 GitHub ↗
                             </a>
diff --git a/source/cli.blade.php b/source/cli.blade.php
new file mode 100644
index 0000000..11cb8f1
--- /dev/null
+++ b/source/cli.blade.php
@@ -0,0 +1,434 @@
+---
+title: contentmd CLI
+description: Command-line tool for browsing and validating content-md sites — fetch pages as an AI agent, run compliance checks, and convert content to agent skills.
+card:
+  template: '_og.page'
+  path: /assets/og/cli.png
+---
+
+@extends('_layouts.main')
+
+@section('body')
+
+<x-page-hero>
+    Validate and browse content-md sites
+
+    <x-slot name="label"><x-eyebrow>CLI</x-eyebrow></x-slot>
+
+    <x-slot name="description">
+        A command-line tool for interacting with content-md sites. Fetch pages as an AI agent would, run compliance checks against the spec, and convert content into agent skills.
+    </x-slot>
+
+    <x-slot name="extra">
+        <div class="space-y-1">
+            <p>
+                <a href="https://github.com/OneOffTech/contentmd/releases/latest" class="select-none inline-block text-center px-3 py-2 leading-4 font-medium text-zinc-700 bg-white hover:bg-zinc-50 dark:bg-zinc-600 dark:text-white dark:hover:bg-zinc-500 focus:outline-none focus:ring-2 focus:ring-orange-500 whitespace-nowrap transition-button ring-1 ring-zinc-950/10 dark:ring-zinc-950/10 shadow-sm" >
+                    Download contentmd
+                </a>
+            </p>
+            <p class="text-sm text-zinc-700">for Windows, Linux and MacOS</p>
+        </div>
+
+    </x-slot>
+</x-page-hero>
+
+
+
+
+{{-- Browse --}}
+<div class="pt-8">
+    <x-section>
+        <x-slot name="eyebrow"><x-eyebrow>Browse</x-eyebrow></x-slot>
+
+        Fetch pages like an AI agent.
+
+        <x-slot name="subheadline">The default command sends <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">Accept: text/markdown</code> and prints the content-md response. Falls back to HTML on 406. Works with single URLs, lists, or entire sitemaps.</x-slot>
+    </x-section>
+
+    <x-container class="mt-4 mb-12">
+        <x-card-grid cols="2-lg">
+            <div class="flex flex-col gap-4">
+                <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                    <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
+                        <span class="text-xs text-zinc-400">Single page</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                    <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
+                        contentmd https://contentmd.org/specification/
+                    </div>
+                </div>
+
+                <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                    <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
+                        <span class="text-xs text-zinc-400">Multiple pages → folder</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                    <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
+                        contentmd <span class="text-yellow-300">--output</span> ./pages \<br>
+                        &nbsp;&nbsp;https://contentmd.org/specification/ \<br>
+                        &nbsp;&nbsp;https://contentmd.org/consumers/
+                    </div>
+                </div>
+
+                <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                    <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
+                        <span class="text-xs text-zinc-400">Full site via sitemap</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                    <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
+                        contentmd <span class="text-yellow-300">--sitemap</span> <span class="text-yellow-300">--output</span> ./pages \<br>
+                        &nbsp;&nbsp;https://contentmd.org
+                    </div>
+                </div>
+            </div>
+
+            <div class="flex flex-col gap-4">
+                <div class="overflow-x-auto agent:hidden">
+                    <table class="w-full text-sm border-collapse">
+                        <thead>
+                            <tr class="border-b border-zinc-300 dark:border-zinc-600">
+                                <th class="text-left py-3 pr-6 font-semibold text-zinc-950 dark:text-white">Flag</th>
+                                <th class="text-left py-3 font-semibold text-zinc-950 dark:text-white">Description</th>
+                            </tr>
+                        </thead>
+                        <tbody class="text-zinc-700 dark:text-zinc-300">
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">--agent</code></td>
+                                <td class="py-3 text-xs">Raw markdown only, no size/token header</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">--sitemap</code></td>
+                                <td class="py-3 text-xs">Fetch <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">/sitemap.xml</code> and iterate every URL in it</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">--output &lt;folder&gt;</code></td>
+                                <td class="py-3 text-xs">Save each response as a <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">.md</code> file (required for multiple URLs)</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">--frontmatter-only</code></td>
+                                <td class="py-3 text-xs">Send <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">Range: x-frontmatter</code> to fetch only the frontmatter</td>
+                            </tr>
+                            <tr>
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">--follow-redirect</code></td>
+                                <td class="py-3 text-xs">Follow HTTP redirects (reported as errors by default)</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+
+                <div class="hidden agent:block prose prose-zinc dark:prose-invert max-w-none">
+                    <table>
+                        <thead>
+                            <tr><th>Flag</th><th>Description</th></tr>
+                        </thead>
+                        <tbody>
+                            <tr><td><code>--agent</code></td><td>Raw markdown only, no size/token header</td></tr>
+                            <tr><td><code>--sitemap</code></td><td>Fetch /sitemap.xml and iterate every URL in it</td></tr>
+                            <tr><td><code>--output &lt;folder&gt;</code></td><td>Save each response as a .md file</td></tr>
+                            <tr><td><code>--frontmatter-only</code></td><td>Fetch only the frontmatter via Range header</td></tr>
+                            <tr><td><code>--follow-redirect</code></td><td>Follow HTTP redirects</td></tr>
+                        </tbody>
+                    </table>
+                </div>
+            </div>
+        </x-card-grid>
+    </x-container>
+</div>
+
+
+{{-- Validate --}}
+<x-section-panel>
+    <x-section>
+        <x-slot name="eyebrow"><x-eyebrow>Validate</x-eyebrow></x-slot>
+
+        Check compliance against the spec.
+
+        <x-slot name="subheadline">The <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">validate</code> subcommand runs a full compliance report against a URL — content negotiation, caching headers, frontmatter fields, document structure, and more. Every check is rated pass, warn, or fail, with a score from 0 to 100.</x-slot>
+    </x-section>
+
+    <x-container class="mt-4 pb-12">
+        <x-card-grid cols="2-lg">
+            <div class="flex flex-col gap-4">
+                <div class="overflow-x-auto agent:hidden">
+                    <table class="w-full text-sm border-collapse">
+                        <thead>
+                            <tr class="border-b border-zinc-300 dark:border-zinc-600">
+                                <th class="text-left py-3 pr-6 font-semibold text-zinc-950 dark:text-white">Check</th>
+                                <th class="text-left py-3 font-semibold text-zinc-950 dark:text-white">What it verifies</th>
+                            </tr>
+                        </thead>
+                        <tbody class="text-zinc-700 dark:text-zinc-300">
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">content-negotiation</code></td>
+                                <td class="py-3 text-xs">Server returns <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">text/markdown</code> for <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">Accept: text/markdown</code></td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">vary-accept</code></td>
+                                <td class="py-3 text-xs">Response includes <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">Vary: Accept</code></td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">frontmatter-title</code></td>
+                                <td class="py-3 text-xs"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">title</code> field present and non-empty</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">frontmatter-description</code></td>
+                                <td class="py-3 text-xs"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">description</code> field present and non-empty</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">heading-h1</code></td>
+                                <td class="py-3 text-xs">Markdown body starts with an H1</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">frontmatter-tokens</code></td>
+                                <td class="py-3 text-xs">Frontmatter is within the ~100 token budget</td>
+                            </tr>
+                            <tr class="border-b border-zinc-300/60 dark:border-zinc-600/60">
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">range-frontmatter</code></td>
+                                <td class="py-3 text-xs"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">Range: x-frontmatter</code> returns only the frontmatter block</td>
+                            </tr>
+                            <tr>
+                                <td class="py-3 pr-6"><code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">title-html-match</code></td>
+                                <td class="py-3 text-xs">Frontmatter title matches the HTML <code class="text-xs bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded">&lt;title&gt;</code></td>
+                            </tr>
+                        </tbody>
+                    </table>
+                    <p class="mt-3 text-xs text-zinc-600 dark:text-zinc-400">And 9 more checks — heading hierarchy, link headers, robots.txt, sitemap presence, description length, and more.</p>
+                </div>
+
+                <div class="hidden agent:block prose prose-zinc dark:prose-invert max-w-none">
+                    <table>
+                        <thead>
+                            <tr><th>Check</th><th>What it verifies</th></tr>
+                        </thead>
+                        <tbody>
+                            <tr><td><code>content-negotiation</code></td><td>Server returns text/markdown for Accept: text/markdown</td></tr>
+                            <tr><td><code>vary-accept</code></td><td>Response includes Vary: Accept</td></tr>
+                            <tr><td><code>frontmatter-title</code></td><td>title field present and non-empty</td></tr>
+                            <tr><td><code>frontmatter-description</code></td><td>description field present and non-empty</td></tr>
+                            <tr><td><code>heading-h1</code></td><td>Markdown body starts with an H1</td></tr>
+                            <tr><td><code>frontmatter-tokens</code></td><td>Frontmatter within ~100 token budget</td></tr>
+                            <tr><td><code>range-frontmatter</code></td><td>Range: x-frontmatter returns only the frontmatter</td></tr>
+                            <tr><td><code>title-html-match</code></td><td>Frontmatter title matches HTML title element</td></tr>
+                        </tbody>
+                    </table>
+                </div>
+            </div>
+
+            <div class="flex flex-col gap-4">
+                <div class="rounded-lg overflow-hidden agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                    <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
+                        <span class="text-xs text-zinc-400">Plain output (default)</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                    <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
+<span class="text-zinc-400">contentmd validate https://contentmd.org/specification/</span><br>
+<br>
+<span class="text-zinc-500">Validating https://contentmd.org/specification/ ...</span><br>
+<br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">content-negotiation</span><br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">vary-accept</span><br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">frontmatter-title</span><br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">frontmatter-description</span><br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">heading-h1</span><br>
+<span class="text-emerald-400">  ✓</span> <span class="text-zinc-300">frontmatter-tokens</span><br>
+<span class="text-yellow-400">  !</span> <span class="text-zinc-300">link-header</span>      <span class="text-zinc-500">— Link header not found</span><br>
+<span class="text-yellow-400">  !</span> <span class="text-zinc-300">html-alternate-link</span> <span class="text-zinc-500">— rel=alternate not set</span><br>
+<br>
+<span class="text-zinc-300">Score: <span class="text-emerald-400">87</span>/100</span>
+                    </div>
+                </div>
+
+                <x-card variant="panel" title="Machine-readable output" size="xs">
+                    Use <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--format json</code> for structured output — useful in CI pipelines or when comparing reports over time.
+                    <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                        <span x-ref="code">contentmd validate <span class="text-yellow-300">--format json</span> https://contentmd.org/</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                </x-card>
+
+                <x-card variant="panel" title="Snapshot and diff" size="xs">
+                    Save a baseline report with <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--save baseline.json</code> and compare it later. Useful for tracking compliance regressions as a site evolves.
+                    <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                        <span x-ref="code">contentmd validate <span class="text-yellow-300">--save baseline.json</span> https://contentmd.org/</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 00-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                </x-card>
+
+                <x-card variant="panel" title="CI-friendly Markdown table" size="xs">
+                    Use <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--format markdown</code> to generate a compliance table suitable for posting in pull request comments.
+                    <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                        <span x-ref="code">contentmd validate <span class="text-yellow-300">--format markdown</span> https://contentmd.org/</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                </x-card>
+            </div>
+        </x-card-grid>
+    </x-container>
+</x-section-panel>
+
+
+{{-- Skill + Agent mode --}}
+<div class="pt-8">
+    <x-section>
+        <x-slot name="eyebrow"><x-eyebrow>More</x-eyebrow></x-slot>
+
+        Skills and agent mode.
+
+        <x-slot name="subheadline">Two more built-in features: convert any content-md page into an agent skill file, and a detection mechanism that lets AI coding agents use the CLI without extra flags.</x-slot>
+    </x-section>
+
+    <x-container class="mb-16 mt-4">
+        <x-card-grid cols="2-lg">
+            <div class="flex flex-col gap-4">
+                <div class="flex items-center gap-2 mb-1">
+                    <code class="text-xs font-medium px-2 py-0.5 rounded bg-zinc-200 dark:bg-zinc-700 text-zinc-700 dark:text-zinc-300">contentmd skill</code>
+                    <span class="text-sm font-semibold text-zinc-950 dark:text-white">Convert to agent skill</span>
+                </div>
+                <p class="text-sm/7 text-zinc-700 dark:text-zinc-400">Converts a content-md page into an <a href="https://agentskills.io" target="_blank" rel="noopener noreferrer" class="underline hover:text-zinc-950 dark:hover:text-white">Agent Skill</a> (<code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded text-xs">SKILL.md</code>) — remapping frontmatter fields and adding a <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded text-xs">source:</code> URL reference.</p>
+                <div class="rounded-lg overflow-hidden agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+                    <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
+                        <span class="text-xs text-zinc-400">Skill command</span>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        </button>
+                    </div>
+                    <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
+                        contentmd skill https://contentmd.org/specification/<br>
+                        <br>
+                        <span class="text-zinc-500"># Write to a file</span><br>
+                        contentmd skill <span class="text-yellow-300">--output SKILL.md</span> https://contentmd.org/specification/
+                    </div>
+                </div>
+            </div>
+
+            <div class="flex flex-col gap-4">
+                <div class="flex items-center gap-2 mb-1">
+                    <code class="text-xs font-medium px-2 py-0.5 rounded bg-zinc-200 dark:bg-zinc-700 text-zinc-700 dark:text-zinc-300">--agent</code>
+                    <span class="text-sm font-semibold text-zinc-950 dark:text-white">Agent mode</span>
+                </div>
+                <p class="text-sm/7 text-zinc-700 dark:text-zinc-400">All three commands support <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded text-xs">--agent</code>. When active, output is stripped of human-readable formatting: raw markdown for browse, JSON for validate, and a structured object for skill.</p>
+                <x-card variant="panel" title="Auto-detected from the environment" size="xs">
+                    Agent mode is implied automatically when coding agent environment variables are set — <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">CLAUDE_CODE</code>, <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">CURSOR_AGENT</code>, <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">GEMINI_CLI</code>, <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">CODEX_SANDBOX</code>, and more. No flag needed when running inside an AI coding agent.
+                </x-card>
+            </div>
+        </x-card-grid>
+    </x-container>
+</div>
+
+<div class="h-16 agent:hidden"></div>
+
+@endsection
+
+@push('markdown')
+
+# contentmd CLI
+
+Command-line tool for browsing and validating content-md formatted web resources — fetch URLs as an AI agent, check compliance, and convert pages to skills.
+
+## Install
+
+Pre-built binaries for Linux, macOS, and Windows are available on [GitHub Releases](https://github.com/OneOffTech/contentmd/releases). No runtime required.
+
+```sh
+# Or build from source
+cargo install contentmd
+```
+
+## Browse
+
+Fetch a URL as an AI agent would — requesting `text/markdown` via content negotiation, falling back to HTML on 406.
+
+```sh
+contentmd https://contentmd.org/specification/
+
+# Multiple pages saved to a folder
+contentmd --output ./pages https://contentmd.org/specification/ https://contentmd.org/consumers/
+
+# Entire site via sitemap
+contentmd --sitemap --output ./pages https://contentmd.org
+```
+
+| Flag | Description |
+| --- | --- |
+| `--agent` | Raw markdown only, no size/token header |
+| `--sitemap` | Fetch `/sitemap.xml` and iterate every URL in it |
+| `--output <folder>` | Save each response as a `.md` file |
+| `--frontmatter-only` | Send `Range: x-frontmatter` to fetch only the frontmatter |
+| `--follow-redirect` | Follow HTTP redirects (reported as errors by default) |
+
+## Validate
+
+Check that a URL correctly serves content-md and report compliance.
+
+```sh
+contentmd validate https://contentmd.org/specification/
+```
+
+Each check is rated **pass**, **warn**, or **fail**. The report includes a **score from 0 to 100**.
+
+| Check | What it verifies |
+| --- | --- |
+| `content-negotiation` | Server returns `text/markdown` for `Accept: text/markdown` |
+| `vary-accept` | Response includes `Vary: Accept` |
+| `frontmatter-title` | `title` field present and non-empty |
+| `frontmatter-description` | `description` field present and non-empty |
+| `heading-h1` | Markdown body starts with an H1 |
+| `frontmatter-tokens` | Frontmatter within ~100 token budget |
+| `range-frontmatter` | `Range: x-frontmatter` returns only the frontmatter |
+| `title-html-match` | Frontmatter title matches HTML `<title>` |
+
+And 9 more checks — heading hierarchy, link headers, robots.txt, sitemap presence, description length, and more.
+
+### Output formats
+
+```sh
+# Machine-readable JSON
+contentmd validate --format json https://contentmd.org/
+
+# Save a baseline for later comparison
+contentmd validate --save baseline.json https://contentmd.org/
+
+# Markdown table for CI comments
+contentmd validate --format markdown https://contentmd.org/
+```
+
+## Skill
+
+Convert a content-md page into an [Agent Skill](https://agentskills.io) (`SKILL.md`).
+
+```sh
+contentmd skill https://contentmd.org/specification/
+
+# Write to a file
+contentmd skill --output SKILL.md https://contentmd.org/specification/
+```
+
+## Agent mode
+
+All three commands support `--agent`. When active, output is stripped of human-readable formatting — raw markdown for browse, JSON for validate, a structured object for skill.
+
+Agent mode is auto-detected from coding agent environment variables: `CLAUDE_CODE`, `CURSOR_AGENT`, `GEMINI_CLI`, `CODEX_SANDBOX`, and more. No flag needed when running inside an AI coding agent.
+
+@endpush
diff --git a/source/index.blade.php b/source/index.blade.php
index 8d57002..e8fdfa0 100644
--- a/source/index.blade.php
+++ b/source/index.blade.php
@@ -64,6 +64,12 @@
 
     <x-container class="mb-16 mt-4">
         <x-card-grid cols="3-sm">
+            <x-card title="contentmd CLI">
+                Browse and validate content-md sites from the command line — fetch pages as an AI agent, run compliance checks, and convert content to agent skills.
+                <x-slot name="action">
+                    <a href="/cli" class="text-sm hover:underline block transition-button">CLI reference →</a>
+                </x-slot>
+            </x-card>
             <x-card title="Caddy Content Negotiation">
                 Serve pre-existing markdown files via the Caddy web server with proper content negotiation headers built in.
                 <x-slot name="action">
@@ -150,6 +156,7 @@
 
 - **Caddy Content Negotiation**: Serve pre-existing markdown files via the Caddy web server with proper content negotiation headers built in. [avvertix/caddy-content-negotiation](https://github.com/avvertix/caddy-content-negotiation/)
 - **WordPress Post to Markdown**: Serve post content as Markdown directly from Wordpress. [roots/post-content-to-markdown](https://github.com/roots/post-content-to-markdown)
+- **contentmd CLI**: Browse and validate content-md sites from the command line — fetch pages as an AI agent, run compliance checks, and convert content to agent skills. [CLI reference](/cli)
 
 ## Comparison
 

From 6ffcedb8c048dd92e448be47a8666a9848060d91 Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Sun, 17 May 2026 21:21:02 +0200
Subject: [PATCH 2/7] Improve content

---
 source/cli.blade.php | 61 ++++++++++++++++++++------------------------
 1 file changed, 28 insertions(+), 33 deletions(-)

diff --git a/source/cli.blade.php b/source/cli.blade.php
index 11cb8f1..685f303 100644
--- a/source/cli.blade.php
+++ b/source/cli.blade.php
@@ -1,6 +1,6 @@
 ---
-title: contentmd CLI
-description: Command-line tool for browsing and validating content-md sites — fetch pages as an AI agent, run compliance checks, and convert content to agent skills.
+title: Content-md command line
+description: Command-line tool for browsing and validating content-md sites. Fetch pages as an AI agent, run compliance checks, and convert content to agent skills.
 card:
   template: '_og.page'
   path: /assets/og/cli.png
@@ -22,8 +22,8 @@
     <x-slot name="extra">
         <div class="space-y-1">
             <p>
-                <a href="https://github.com/OneOffTech/contentmd/releases/latest" class="select-none inline-block text-center px-3 py-2 leading-4 font-medium text-zinc-700 bg-white hover:bg-zinc-50 dark:bg-zinc-600 dark:text-white dark:hover:bg-zinc-500 focus:outline-none focus:ring-2 focus:ring-orange-500 whitespace-nowrap transition-button ring-1 ring-zinc-950/10 dark:ring-zinc-950/10 shadow-sm" >
-                    Download contentmd
+                <a href="https://github.com/OneOffTech/contentmd/releases/latest" class="select-none inline-block text-center px-4 py-3 leading-4 font-medium text-zinc-700 bg-white hover:bg-zinc-50 dark:bg-zinc-600 dark:text-white dark:hover:bg-zinc-500 focus:outline-none focus:ring-2 focus:ring-orange-500 whitespace-nowrap transition-button ring-1 ring-zinc-950/10 dark:ring-zinc-950/10 shadow-sm" >
+                    Download from GitHub
                 </a>
             </p>
             <p class="text-sm text-zinc-700">for Windows, Linux and MacOS</p>
@@ -51,9 +51,9 @@
                 <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                     <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
                         <span class="text-xs text-zinc-400">Single page</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-4 shrink-0 hit-area-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                     <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
@@ -64,9 +64,9 @@
                 <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                     <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
                         <span class="text-xs text-zinc-400">Multiple pages → folder</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-4 shrink-0 hit-area-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                     <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
@@ -79,9 +79,9 @@
                 <div class="rounded-lg overflow-hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                     <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
                         <span class="text-xs text-zinc-400">Full site via sitemap</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-4 shrink-0 hit-area-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                     <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
@@ -227,9 +227,9 @@
                 <div class="rounded-lg overflow-hidden agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                     <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
                         <span class="text-xs text-zinc-400">Plain output (default)</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-4 shrink-0 hit-area-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                     <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
@@ -254,9 +254,9 @@
                     Use <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--format json</code> for structured output — useful in CI pipelines or when comparing reports over time.
                     <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                         <span x-ref="code">contentmd validate <span class="text-yellow-300">--format json</span> https://contentmd.org/</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-6 shrink-0 hit-area-2 absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                 </x-card>
@@ -265,9 +265,9 @@
                     Save a baseline report with <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--save baseline.json</code> and compare it later. Useful for tracking compliance regressions as a site evolves.
                     <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                         <span x-ref="code">contentmd validate <span class="text-yellow-300">--save baseline.json</span> https://contentmd.org/</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 00-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-6 shrink-0 hit-area-2 absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                 </x-card>
@@ -276,9 +276,9 @@
                     Use <code class="bg-zinc-200 dark:bg-zinc-700 px-1 rounded">--format markdown</code> to generate a compliance table suitable for posting in pull request comments.
                     <div class="relative rounded bg-zinc-950 p-3 font-mono text-xs text-zinc-100 mt-3 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                         <span x-ref="code">contentmd validate <span class="text-yellow-300">--format markdown</span> https://contentmd.org/</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-6 shrink-0 hit-area-2 absolute top-2 right-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                 </x-card>
@@ -309,9 +309,9 @@
                 <div class="rounded-lg overflow-hidden agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
                     <div class="bg-zinc-800 dark:bg-zinc-900 px-4 py-2 flex items-center justify-between gap-2">
                         <span class="text-xs text-zinc-400">Skill command</span>
-                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
-                            <svg x-show="!copied" class="size-3.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
-                            <svg x-show="copied" class="size-3.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+                        <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="size-4 shrink-0 hit-area-2 text-zinc-500 hover:text-zinc-300 transition-colors" aria-label="Copy to clipboard">
+                            <svg x-show="!copied" class="size-4.5" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                            <svg x-show="copied" class="size-4.5 text-emerald-400" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
                         </button>
                     </div>
                     <div class="bg-zinc-950 p-4 font-mono text-xs leading-relaxed text-zinc-100 overflow-x-auto" x-ref="code">
@@ -351,11 +351,6 @@
 
 Pre-built binaries for Linux, macOS, and Windows are available on [GitHub Releases](https://github.com/OneOffTech/contentmd/releases). No runtime required.
 
-```sh
-# Or build from source
-cargo install contentmd
-```
-
 ## Browse
 
 Fetch a URL as an AI agent would — requesting `text/markdown` via content negotiation, falling back to HTML on 406.

From 29be24f8f70f8cbd32dd53047adf1bb7995e3f2c Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Sun, 17 May 2026 21:21:11 +0200
Subject: [PATCH 3/7] Check active pages

---
 config.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/config.php b/config.php
index 0a77c51..a8e6d7b 100644
--- a/config.php
+++ b/config.php
@@ -25,4 +25,15 @@
         return  '/' . trimPath($path);
 
     },
+
+    'isActive' => function ($page, $path) {
+        $pagePath = str_replace('\\', '/', trimPath($page->getPath()));
+        $path = trimPath($path);
+
+        if(Str::endsWith($path, '*')){
+            $path = rtrim($path, '*');
+            return Str::startsWith($pagePath, $path) || $pagePath === $path;
+        }
+        return Str::endsWith($pagePath, $path) || $pagePath === $path;
+    },
 ];

From 1fdbde5a2d41e63d50a6f5f010fc70e8bf087134 Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Sun, 17 May 2026 21:21:36 +0200
Subject: [PATCH 4/7] Clean unneeded entries

---
 src/Listeners/GenerateSitemap.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Listeners/GenerateSitemap.php b/src/Listeners/GenerateSitemap.php
index 5b44dd2..bbb387e 100644
--- a/src/Listeners/GenerateSitemap.php
+++ b/src/Listeners/GenerateSitemap.php
@@ -11,7 +11,8 @@ class GenerateSitemap
     protected $exclude = [
         '/assets/*',
         '*/favicon.ico',
-        '*/404*'
+        '*/404*',
+        '*/robots.txt',
     ];
 
     public function handle(Jigsaw $jigsaw)

From cb2b19f47919ef884d97066b48e5524cd4f62184 Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Mon, 18 May 2026 11:05:16 +0200
Subject: [PATCH 5/7] Remove duplicate meta description

---
 source/_layouts/main.blade.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/source/_layouts/main.blade.php b/source/_layouts/main.blade.php
index a8008b4..895cfbe 100644
--- a/source/_layouts/main.blade.php
+++ b/source/_layouts/main.blade.php
@@ -29,7 +29,6 @@
         <meta property="og:title" content="{{ $page->title ?? $page->siteTitle }}">
 
         <meta property="og:locale" content="en_US">
-        <meta name="description" content="{{ $page->description ?? $page->siteDescription }}">
         <meta property="og:description" content="{{ $page->description ?? $page->siteDescription }}">
         <meta property="og:url" content="{{ $page->url($page->getUrl()) }}">
         <meta property="og:site_name" content="OneOffTech">

From 9b82890529c9b3f2f6dae3b2f97cb2017c87d66f Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Mon, 18 May 2026 11:57:32 +0200
Subject: [PATCH 6/7] Cite command line

---
 README.md                                 |  5 ++-
 source/_components/code-snippet.blade.php |  7 +++
 source/badge-flat.svg                     | 14 ++++++
 source/badge.svg                          | 22 +++++++++
 source/index.blade.php                    | 55 +++++++++++++++++++++++
 5 files changed, 102 insertions(+), 1 deletion(-)
 create mode 100644 source/_components/code-snippet.blade.php
 create mode 100644 source/badge-flat.svg
 create mode 100644 source/badge.svg

diff --git a/README.md b/README.md
index 229f9cf..a51d69a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+[![Supports content-md format for AI Agents](https://contentmd.org/badge.svg)](https://contentmd.org)
+
 # Content-md
 
 [content-md](https://contentmd.org) is an open specification for structuring content to be consumed by AI agents.
@@ -8,8 +10,9 @@ Content-md synthesizes the current practices of structuring the markdown represe
 
 - **[Documentation](https://contentmd.org)** — Motivation, guides and tutorials
 - **[Specification](https://contentmd.org/specification)** — Format details
+- **[`contentmd` Command Line](https://contentmd.org/cli)** — Fetch and validate markdown
 
-This repo contains the specification, documentation, and reference guides.
+This repo contains the specification, documentation, reference guides, and the Rust command line.
 
 ## About
 
diff --git a/source/_components/code-snippet.blade.php b/source/_components/code-snippet.blade.php
new file mode 100644
index 0000000..07873ed
--- /dev/null
+++ b/source/_components/code-snippet.blade.php
@@ -0,0 +1,7 @@
+<div class="relative rounded bg-zinc-200 dark:bg-zinc-800 p-3 pr-8 font-mono text-xs text-zinc-900 dark:text-zinc-100 overflow-x-auto agent:hidden" x-data="{ copied: false }" x-bind:data-copied="copied">
+    <span x-ref="code">{{ $slot }}</span>
+    <button type="button" @click="navigator.clipboard.writeText($refs.code.innerText.trim()).then(() => { copied = true; setTimeout(() => copied = false, 2000) })" class="absolute hit-area-2 size-6 shrink-0 top-2 right-2 text-zinc-900 dark:text-zinc-100 hover:text-zinc-950 dark:hover:text-white transition-colors" aria-label="Copy to clipboard">
+        <svg x-show="!copied" class="size-4" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+        <svg x-show="copied" class="size-4 text-emerald-700 dark:text-emerald-400" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M16.704 4.153a.75.75 0 0 1 .143 1.052l-8 10.5a.75.75 0 0 1-1.127.075l-4.5-4.5a.75.75 0 0 1 1.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 0 1 1.05-.143Z" clip-rule="evenodd"></path></svg>
+    </button>
+</div>
\ No newline at end of file
diff --git a/source/badge-flat.svg b/source/badge-flat.svg
new file mode 100644
index 0000000..e0022f3
--- /dev/null
+++ b/source/badge-flat.svg
@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="132" height="20">
+    <g>
+        <rect x="0" width="132" height="20" fill="#ea580c"/>
+    </g>
+    <g fill="#fff">
+        <svg x="5" y="3" width="14" height="14" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
+            <path d="M0,52.67v-1.95h73.85v1.95H0ZM6.15,33.18v-1.95h67.69v1.95H6.15ZM6.15,48.78v-1.95h73.85v1.95H6.15ZM6.15,68.26v-1.95h12.31v1.95H6.15ZM6.15,72.16v-1.95h12.31v1.95H6.15ZM6.15,76.06v-1.95h12.31v1.95H6.15ZM12.31,29.27v-1.95h67.69v1.95H12.31ZM12.31,56.57v-1.95h12.31v1.95h-12.31ZM12.31,60.46v-1.95h12.31v1.95h-12.31ZM12.31,64.36v-1.95h12.31v1.95h-12.31ZM18.46,37.07v-1.95h12.3v1.95h-12.3ZM18.46,40.98v-1.95h12.3v1.95h-12.3ZM18.46,44.87v-1.95h12.3v1.95h-12.3ZM24.62,17.58v-1.95h12.3v1.95h-12.3ZM24.62,21.48v-1.95h12.3v1.95h-12.3ZM24.62,25.38v-1.95h12.3v1.95h-12.3ZM30.77,5.88v-1.95h12.31v1.95h-12.31ZM30.77,9.78v-1.95h12.31v1.95h-12.31ZM30.77,13.68v-1.95h12.31v1.95h-12.31ZM36.92,68.26v-1.95h12.31v1.95h-12.31ZM36.92,72.16v-1.95h12.31v1.95h-12.31ZM36.92,76.06v-1.95h12.31v1.95h-12.31ZM43.07,56.57v-1.95h12.31v1.95h-12.31ZM43.07,60.46v-1.95h12.31v1.95h-12.31ZM43.07,64.36v-1.95h12.31v1.95h-12.31ZM49.23,37.07v-1.95h12.31v1.95h-12.31ZM49.23,40.98v-1.95h12.31v1.95h-12.31ZM49.23,44.87v-1.95h12.31v1.95h-12.31ZM55.38,17.58v-1.95h12.31v1.95h-12.31ZM55.38,21.48v-1.95h12.31v1.95h-12.31ZM55.38,25.38v-1.95h12.31v1.95h-12.31ZM61.54,5.88v-1.95h12.31v1.95h-12.31ZM61.54,9.78v-1.95h12.31v1.95h-12.31ZM61.54,13.68v-1.95h12.31v1.95h-12.31Z" fill="#fff"/>
+        </svg>
+    </g>
+    <g fill="#fff" text-anchor="left" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+        <text x="26" y="15" fill="#010101" fill-opacity=".3">content-md</text>
+        <text x="26" y="14">content-md</text>
+    </g>
+</svg>
diff --git a/source/badge.svg b/source/badge.svg
new file mode 100644
index 0000000..69f36eb
--- /dev/null
+++ b/source/badge.svg
@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="132" height="20">
+    <linearGradient id="b" x2="0" y2="100%">
+        <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+        <stop offset="1" stop-opacity=".1"/>
+    </linearGradient>
+    <mask id="a">
+        <rect width="132" height="20" rx="3" fill="#fff"/>
+    </mask>
+    <g mask="url(#a)">
+        <path fill="#ea580c" d="M0 0h24v20H0zM24 0h125v20H24z"/>
+        <path fill="url(#b)" d="M0 0h132v20H0z"/>
+    </g>
+    <g fill="#fff">
+        <svg x="5" y="3" width="14" height="14" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
+            <path d="M0,52.67v-1.95h73.85v1.95H0ZM6.15,33.18v-1.95h67.69v1.95H6.15ZM6.15,48.78v-1.95h73.85v1.95H6.15ZM6.15,68.26v-1.95h12.31v1.95H6.15ZM6.15,72.16v-1.95h12.31v1.95H6.15ZM6.15,76.06v-1.95h12.31v1.95H6.15ZM12.31,29.27v-1.95h67.69v1.95H12.31ZM12.31,56.57v-1.95h12.31v1.95h-12.31ZM12.31,60.46v-1.95h12.31v1.95h-12.31ZM12.31,64.36v-1.95h12.31v1.95h-12.31ZM18.46,37.07v-1.95h12.3v1.95h-12.3ZM18.46,40.98v-1.95h12.3v1.95h-12.3ZM18.46,44.87v-1.95h12.3v1.95h-12.3ZM24.62,17.58v-1.95h12.3v1.95h-12.3ZM24.62,21.48v-1.95h12.3v1.95h-12.3ZM24.62,25.38v-1.95h12.3v1.95h-12.3ZM30.77,5.88v-1.95h12.31v1.95h-12.31ZM30.77,9.78v-1.95h12.31v1.95h-12.31ZM30.77,13.68v-1.95h12.31v1.95h-12.31ZM36.92,68.26v-1.95h12.31v1.95h-12.31ZM36.92,72.16v-1.95h12.31v1.95h-12.31ZM36.92,76.06v-1.95h12.31v1.95h-12.31ZM43.07,56.57v-1.95h12.31v1.95h-12.31ZM43.07,60.46v-1.95h12.31v1.95h-12.31ZM43.07,64.36v-1.95h12.31v1.95h-12.31ZM49.23,37.07v-1.95h12.31v1.95h-12.31ZM49.23,40.98v-1.95h12.31v1.95h-12.31ZM49.23,44.87v-1.95h12.31v1.95h-12.31ZM55.38,17.58v-1.95h12.31v1.95h-12.31ZM55.38,21.48v-1.95h12.31v1.95h-12.31ZM55.38,25.38v-1.95h12.31v1.95h-12.31ZM61.54,5.88v-1.95h12.31v1.95h-12.31ZM61.54,9.78v-1.95h12.31v1.95h-12.31ZM61.54,13.68v-1.95h12.31v1.95h-12.31Z" fill="#fff"/>
+        </svg>
+    </g>
+    <g fill="#fff" text-anchor="left" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+        <text x="26" y="15" fill="#010101" fill-opacity=".3">content-md</text>
+        <text x="26" y="14">content-md</text>
+    </g>
+</svg>
diff --git a/source/index.blade.php b/source/index.blade.php
index e8fdfa0..ef0be2b 100644
--- a/source/index.blade.php
+++ b/source/index.blade.php
@@ -123,6 +123,47 @@
     </x-container>
 </x-section-panel>
 
+
+{{-- Badges --}}
+<div class="pt-8">
+    <x-section>
+        <x-slot name="eyebrow"><x-eyebrow>Badges</x-eyebrow></x-slot>
+
+        We have badges too
+
+        <x-slot name="subheadline">Add a badge to show that your project or site serves content-md.</x-slot>
+    </x-section>
+
+    <x-container class="mb-16 mt-4">
+        <x-card-grid>
+            <div class="flex flex-col gap-3">
+                <div class="rounded-lg py-5 flex items-center  agent:hidden">
+                    <img src="/badge.svg" alt="content-md badge" width="132" height="20">
+                </div>
+                <p class="text-xs text-zinc-500 dark:text-zinc-400 agent:hidden">Markdown</p>
+                <x-code-snippet>[![Supports content-md format for AI Agents](https://contentmd.org/badge.svg)](https://contentmd.org)</x-code-snippet>
+                <p class="text-xs text-zinc-500 dark:text-zinc-400 agent:hidden">HTML</p>
+                <x-code-snippet>&lt;a href="https://contentmd.org"&gt;&lt;img src="https://contentmd.org/badge.svg" alt="Supports content-md format for AI Agents"&gt;&lt;/a&gt;</x-code-snippet>
+            </div>
+
+            <div class="flex flex-col gap-3">
+                <div class="rounded-lg py-5 flex items-center  agent:hidden">
+                    <img src="/badge-flat.svg" alt="content-md flat badge" width="132" height="20">
+                </div>
+                <p class="text-xs text-zinc-500 dark:text-zinc-400 agent:hidden">Markdown</p>
+                <x-code-snippet>[![Supports content-md format for AI Agents](https://contentmd.org/badge-flat.svg)](https://contentmd.org)</x-code-snippet>
+                <p class="text-xs text-zinc-500 dark:text-zinc-400 agent:hidden">HTML</p>
+                <x-code-snippet>&lt;a href="https://contentmd.org"&gt;&lt;img src="https://contentmd.org/badge-flat.svg" alt="Supports content-md format for AI Agents"&gt;&lt;/a&gt;</x-code-snippet>
+            </div>
+        </x-card-grid>
+
+        <div class="hidden agent:block prose prose-zinc dark:prose-invert max-w-none mt-4">
+            <p><strong>Standard:</strong> <code>[![Supports content-md format for AI Agents](https://contentmd.org/badge.svg)](https://contentmd.org)</code></p>
+            <p><strong>Flat:</strong> <code>[![Supports content-md format for AI Agents](https://contentmd.org/badge-flat.svg)](https://contentmd.org)</code></p>
+        </div>
+    </x-container>
+</div>
+
 <div class="h-28 agent:hidden"></div>
 
 <x-container class="relative grid grid-rows-2 agent:hidden">
@@ -172,6 +213,20 @@
 
 Skills provides additional knowledge to agents, currently within dedicated folders. content-md responses are nearly compatible with Skills; the frontmatter fields map closely.
 
+## Badges
+
+Promote the usage of content-md via the badge.
+
+Standard badge:
+```
+[![content-md](https://contentmd.org/badge.svg)](https://contentmd.org)
+```
+
+Flat badge:
+```
+[![content-md](https://contentmd.org/badge-flat.svg)](https://contentmd.org)
+```
+
 <nav>
 - [Reference — frontmatter fields and custom block syntax](/reference)
 - [For Content Producers — best practices for writing content-md documents](/producers)

From 8024402e4d562cfe20ce1c32113722754d2009ff Mon Sep 17 00:00:00 2001
From: Alessio Vertemati <alessio.vertemati@gmail.com>
Date: Mon, 18 May 2026 11:59:17 +0200
Subject: [PATCH 7/7] Improve dark mode

---
 source/cli.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/cli.blade.php b/source/cli.blade.php
index 685f303..697f029 100644
--- a/source/cli.blade.php
+++ b/source/cli.blade.php
@@ -26,7 +26,7 @@
                     Download from GitHub
                 </a>
             </p>
-            <p class="text-sm text-zinc-700">for Windows, Linux and MacOS</p>
+            <p class="text-sm text-zinc-700 dark:text-zinc-200">for Windows, Linux and MacOS</p>
         </div>
 
     </x-slot>