@kamod-ch/preactpress 1.0.0

package/templates/docs/dist/preactpress-content/guide__markdown-and-mdx.json

@@ -0,0 +1,31 @@
+{
+  "kind": "markdown",
+  "meta": {
+    "title": "Markdown and MDX",
+    "description": "Author static Markdown pages and interactive MDX pages."
+  },
+  "html": "<p>Use <code>.md</code> for content that does not need browser-side components. Use <code>.mdx</code> when a page imports and renders Preact components.</p>\n<h2 id=\"markdown\" class=\"pp-heading\">Markdown<a class=\"pp-heading-anchor\" href=\"#markdown\" aria-label=\"Link to this section\">#</a></h2>\n<p>Markdown pages support frontmatter, heading anchors, syntax highlighting, tables, containers, GFM alerts, code groups, file includes, snippet imports, emoji, optional MathJax, and <code>[[toc]]</code>.</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">---</span></span>\n<span class=\"line\"><span style=\"color:#22863A;--shiki-dark:#85E89D\">title</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">API guide</span></span>\n<span class=\"line\"><span style=\"color:#22863A;--shiki-dark:#85E89D\">description</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">Integrate the API</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">---</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\">## Authentication</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">::: warning</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">Never commit production credentials.</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">:::</span></span></code></pre><p>Raw HTML is disabled by default. Enable <code>markdown.html</code> only when every author is trusted.</p>\n<h2 id=\"mdx\" class=\"pp-heading\">MDX<a class=\"pp-heading-anchor\" href=\"#mdx\" aria-label=\"Link to this section\">#</a></h2>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">---</span></span>\n<span class=\"line\"><span style=\"color:#22863A;--shiki-dark:#85E89D\">title</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">Counter demo</span></span>\n<span class=\"line\"><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">---</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">import</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> Counter </span><span style=\"color:#D73A49;--shiki-dark:#F97583\">from</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> './components/Counter.tsx'</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\">## Demo</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">&#x3C;</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">Counter</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\"> initial</span><span style=\"color:#D73A49;--shiki-dark:#F97583\">=</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">{</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">3</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">} /></span></span></code></pre><p>MDX pages hydrate in the browser. Regular Markdown payloads are loaded as HTML, which keeps larger documentation sites from bundling every page body into JavaScript.</p>\n<h2 id=\"reusing-content\" class=\"pp-heading\">Reusing content<a class=\"pp-heading-anchor\" href=\"#reusing-content\" aria-label=\"Link to this section\">#</a></h2>\n<p>Import a source snippet relative to <code>srcDir</code>:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">&#x3C;&#x3C;&#x3C; @/snippets/example.ts{2,4}</span></span></code></pre><p>Include a Markdown fragment:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">::: tip Shared fragment</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">This note is pulled in via </span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">`&#x3C;!-- include cycle detected: /home/watzak/master/kamod/preactpress/templates/docs/partials/shared-note.md -->`</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">.</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">:::</span></span></code></pre><p>Exclude fragments from routing with <code>srcExclude</code>.</p>\n<p>See <a href=\"/markdown-examples\">Markdown examples</a> for rendered examples.</p>\n",
+  "title": "Markdown and MDX",
+  "description": "Author static Markdown pages and interactive MDX pages.",
+  "tags": [],
+  "pageType": "website",
+  "headings": [
+    {
+      "id": "markdown",
+      "text": "Markdown",
+      "level": 2
+    },
+    {
+      "id": "mdx",
+      "text": "MDX",
+      "level": 2
+    },
+    {
+      "id": "reusing-content",
+      "text": "Reusing content",
+      "level": 2
+    }
+  ],
+  "relativePath": "guide/markdown-and-mdx.md",
+  "lastUpdated": "2026-06-08T15:16:59.429Z"
+}

package/templates/docs/dist/preactpress-content/guide__routing.json

@@ -0,0 +1,71 @@
+{
+  "kind": "markdown",
+  "meta": {
+    "title": "Routing",
+    "description": "Understand how PreactPress maps files to URLs"
+  },
+  "html": "<h1 id=\"routing\" class=\"pp-heading\">Routing<a class=\"pp-heading-anchor\" href=\"#routing\" aria-label=\"Link to this section\">#</a></h1>\n<p>PreactPress uses file-based routing. Every <code>.md</code> and <code>.mdx</code> file under <code>srcDir</code> becomes a route, and production builds write each route as static HTML.</p>\n<h2 id=\"file-based-routing\" class=\"pp-heading\">File-based routing<a class=\"pp-heading-anchor\" href=\"#file-based-routing\" aria-label=\"Link to this section\">#</a></h2>\n<p>Given this structure:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>.</span></span>\n<span class=\"line\"><span>├── index.md</span></span>\n<span class=\"line\"><span>├── about.md</span></span>\n<span class=\"line\"><span>├── guide/</span></span>\n<span class=\"line\"><span>│   ├── index.md</span></span>\n<span class=\"line\"><span>│   └── getting-started.md</span></span>\n<span class=\"line\"><span>└── interactive.mdx</span></span></code></pre><p>PreactPress creates these routes:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>index.md                  -> /</span></span>\n<span class=\"line\"><span>about.md                  -> /about</span></span>\n<span class=\"line\"><span>guide/index.md            -> /guide</span></span>\n<span class=\"line\"><span>guide/getting-started.md  -> /guide/getting-started</span></span>\n<span class=\"line\"><span>interactive.mdx           -> /interactive</span></span></code></pre><p>During production builds, routes are written as directory indexes:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>/                      -> dist/index.html</span></span>\n<span class=\"line\"><span>/about                 -> dist/about/index.html</span></span>\n<span class=\"line\"><span>/guide/getting-started -> dist/guide/getting-started/index.html</span></span></code></pre><p>By default (<code>cleanUrls: true</code>), builds emit directory indexes so hosts can serve extensionless URLs.</p>\n<h2 id=\"project-root-and-source-directory\" class=\"pp-heading\">Project root and source directory<a class=\"pp-heading-anchor\" href=\"#project-root-and-source-directory\" aria-label=\"Link to this section\">#</a></h2>\n<p>The project root is where PreactPress looks for <code>.preactpress/config.ts</code>.</p>\n<p>By default, source files also live in the project root:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>.</span></span>\n<span class=\"line\"><span>├── .preactpress/</span></span>\n<span class=\"line\"><span>│   └── config.ts</span></span>\n<span class=\"line\"><span>├── index.md</span></span>\n<span class=\"line\"><span>└── guide/</span></span>\n<span class=\"line\"><span>    └── getting-started.md</span></span></code></pre><p>You can move content into a nested source directory with <code>srcDir</code>:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  srcDir: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'docs'</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>That produces this shape:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>.</span></span>\n<span class=\"line\"><span>├── .preactpress/</span></span>\n<span class=\"line\"><span>│   └── config.ts</span></span>\n<span class=\"line\"><span>└── docs/</span></span>\n<span class=\"line\"><span>    ├── index.md</span></span>\n<span class=\"line\"><span>    └── guide/</span></span>\n<span class=\"line\"><span>        └── getting-started.md</span></span></code></pre><p>The resulting routes stay the same:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>docs/index.md                  -> /</span></span>\n<span class=\"line\"><span>docs/guide/getting-started.md  -> /guide/getting-started</span></span></code></pre><h2 id=\"linking-between-pages\" class=\"pp-heading\">Linking between pages<a class=\"pp-heading-anchor\" href=\"#linking-between-pages\" aria-label=\"Link to this section\">#</a></h2>\n<p>Use absolute or relative links. The recommended style is to omit file extensions:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">[</span><span style=\"color:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline\">Getting Started</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">](</span><span style=\"color:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline\">/guide/getting-started</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">)</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">[</span><span style=\"color:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline\">Routing</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">](</span><span style=\"color:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline\">./routing</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">)</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">[</span><span style=\"color:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline\">Home</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">](</span><span style=\"color:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline\">../</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">)</span></span></code></pre><p>Avoid linking directly to generated HTML or source Markdown:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6A737D;--shiki-dark:#6A737D\">&#x3C;!-- Avoid --></span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">[</span><span style=\"color:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline\">Getting Started</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">](</span><span style=\"color:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline\">/guide/getting-started.md</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">)</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">[</span><span style=\"color:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline\">Getting Started</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">](</span><span style=\"color:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline\">/guide/getting-started.html</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">)</span></span></code></pre><p><code>preactpress check</code> validates local Markdown links that use <code>.md</code>, <code>.mdx</code>, or <code>.html</code> extensions and reports missing pages.</p>\n<h2 id=\"locale-routes\" class=\"pp-heading\">Locale routes<a class=\"pp-heading-anchor\" href=\"#locale-routes\" aria-label=\"Link to this section\">#</a></h2>\n<p>PreactPress supports VitePress-style locale folders. Keep the default language at the root and put translations in locale folders:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>index.md                       -> /</span></span>\n<span class=\"line\"><span>guide/getting-started.md       -> /guide/getting-started</span></span>\n<span class=\"line\"><span>de/index.md                    -> /de</span></span>\n<span class=\"line\"><span>de/guide/getting-started.md    -> /de/guide/getting-started</span></span></code></pre><p>Configure locale labels, language codes, and locale-specific nav in <code>.preactpress/config.ts</code>:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  locales: {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    root: {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      label: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'English'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">,</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      lang: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'en'</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    },</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    de: {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      label: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Deutsch'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">,</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      lang: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'de'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">,</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      link: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/de/'</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>The default theme shows a language switcher when multiple locales are configured.</p>\n<h2 id=\"tag-routes\" class=\"pp-heading\">Tag routes<a class=\"pp-heading-anchor\" href=\"#tag-routes\" aria-label=\"Link to this section\">#</a></h2>\n<p>Pages can define tags in frontmatter:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">---</span></span>\n<span class=\"line\"><span style=\"color:#22863A;--shiki-dark:#85E89D\">title</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">Release notes</span></span>\n<span class=\"line\"><span style=\"color:#22863A;--shiki-dark:#85E89D\">tags</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: [</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">release</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">, </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">changelog</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">]</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">---</span></span></code></pre><p>Each tag receives an index page:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>release   -> /tags/release</span></span>\n<span class=\"line\"><span>changelog -> /tags/changelog</span></span></code></pre><p>For localized content, tag pages are scoped to the locale:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>de/guide/intro.md with tag \"Markdown\" -> /de/tags/markdown</span></span></code></pre><p>If a real Markdown or MDX page exists at the same route as a generated tag index, the real page wins.</p>\n<h2 id=\"base-path\" class=\"pp-heading\">Base path<a class=\"pp-heading-anchor\" href=\"#base-path\" aria-label=\"Link to this section\">#</a></h2>\n<p>Use <code>site.base</code> when the site is served from a subpath, for example GitHub Pages project sites:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  site: {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    base: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/my-repo/'</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>You can also override it for one build:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">pnpm</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> exec</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> preactpress</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> build</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\"> --base</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> /my-repo/</span></span></code></pre><h2 id=\"route-rewrites\" class=\"pp-heading\">Route rewrites<a class=\"pp-heading-anchor\" href=\"#route-rewrites\" aria-label=\"Link to this section\">#</a></h2>\n<p>Map a public URL to existing content without duplicating files:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  rewrites: {</span></span>\n<span class=\"line\"><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">    '/docs'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/guide'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">,</span></span>\n<span class=\"line\"><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">    '/getting-started'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/guide/intro'</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>Keys are the routes visitors use; values must point at routes that already exist from your Markdown files. <code>preactpress check</code> validates rewrite sources and collisions.</p>\n<h2 id=\"clean-urls-and-hosting\" class=\"pp-heading\">Clean URLs and hosting<a class=\"pp-heading-anchor\" href=\"#clean-urls-and-hosting\" aria-label=\"Link to this section\">#</a></h2>\n<table>\n<thead>\n<tr>\n<th><code>cleanUrls</code></th>\n<th>Output for <code>/about</code></th>\n<th>Typical host</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>true</code> (default)</td>\n<td><code>dist/about/index.html</code></td>\n<td>Netlify, Vercel, Cloudflare Pages, GitHub Pages</td>\n</tr>\n<tr>\n<td><code>false</code></td>\n<td><code>dist/about.html</code></td>\n<td>Static buckets without directory index support</td>\n</tr>\n</tbody>\n</table>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  cleanUrls: </span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">false</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>Most modern static hosts work with the default. Set <code>cleanUrls: false</code> only when your host cannot resolve <code>/about</code> to <code>about/index.html</code>.</p>\n<h2 id=\"dynamic-routes\" class=\"pp-heading\">Dynamic routes<a class=\"pp-heading-anchor\" href=\"#dynamic-routes\" aria-label=\"Link to this section\">#</a></h2>\n<p>Generate routes at build time with a bracket template and a colocated <code>.paths.ts</code> file:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6A737D;--shiki-dark:#6A737D\">&#x3C;!-- packages/[pkg].md --></span></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\">---</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">title: \"{{ params.pkg }}\"</span></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\">---</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\"># {{ params.pkg }}</span></span></code></pre><pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6A737D;--shiki-dark:#6A737D\">// packages/[pkg].paths.ts</span></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {</span></span>\n<span class=\"line\"><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">  paths</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">() {</span></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">    return</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> [</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      { params: { pkg: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'preact'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> } },</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      { params: { pkg: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'vite'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }, props: { note: </span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Build tool'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> } }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    ]</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>This emits <code>/packages/preact</code> and <code>/packages/vite</code>. Use <code>{{ params.key }}</code> and <code>{{ props.key }}</code> in frontmatter and body.</p>\n<h2 id=\"data-loaders\" class=\"pp-heading\">Data loaders<a class=\"pp-heading-anchor\" href=\"#data-loaders\" aria-label=\"Link to this section\">#</a></h2>\n<p>Colocate <code>*.data.ts</code> with a page to load build-time data via <code>createContentLoader</code> from <code>preactpress/config</code>. The result is exposed on <code>page.meta.contentData</code> (and in themes through the <code>page</code> prop).</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6A737D;--shiki-dark:#6A737D\">// blog.data.ts</span></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">import</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { createContentLoader } </span><span style=\"color:#D73A49;--shiki-dark:#F97583\">from</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> 'preactpress/config'</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> default</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\"> createContentLoader</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">(</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">'posts/*.md'</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">, {</span></span>\n<span class=\"line\"><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">  transform</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">(</span><span style=\"color:#E36209;--shiki-dark:#FFAB70\">items</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">) {</span></span>\n<span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">    return</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> items.</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">map</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">((</span><span style=\"color:#E36209;--shiki-dark:#FFAB70\">item</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">) </span><span style=\"color:#D73A49;--shiki-dark:#F97583\">=></span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> ({</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      title: item.title,</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">      route: item.route</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">    }))</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">  }</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">})</span></span></code></pre><p>Pair with <code>blog.md</code> or <code>blog/index.md</code> for route <code>/blog</code>.</p>\n<h2 id=\"current-limitations\" class=\"pp-heading\">Current limitations<a class=\"pp-heading-anchor\" href=\"#current-limitations\" aria-label=\"Link to this section\">#</a></h2>\n<table>\n<thead>\n<tr>\n<th>Feature</th>\n<th>Status</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Dynamic MDX templates (<code>[id].mdx</code>)</td>\n<td>Not supported (use <code>.md</code> templates)</td>\n</tr>\n<tr>\n<td>Pattern-based rewrites with params</td>\n<td>Not supported</td>\n</tr>\n</tbody>\n</table>\n",
+  "title": "Routing",
+  "description": "Understand how PreactPress maps files to URLs",
+  "tags": [],
+  "pageType": "website",
+  "headings": [
+    {
+      "id": "file-based-routing",
+      "text": "File-based routing",
+      "level": 2
+    },
+    {
+      "id": "project-root-and-source-directory",
+      "text": "Project root and source directory",
+      "level": 2
+    },
+    {
+      "id": "linking-between-pages",
+      "text": "Linking between pages",
+      "level": 2
+    },
+    {
+      "id": "locale-routes",
+      "text": "Locale routes",
+      "level": 2
+    },
+    {
+      "id": "tag-routes",
+      "text": "Tag routes",
+      "level": 2
+    },
+    {
+      "id": "base-path",
+      "text": "Base path",
+      "level": 2
+    },
+    {
+      "id": "route-rewrites",
+      "text": "Route rewrites",
+      "level": 2
+    },
+    {
+      "id": "clean-urls-and-hosting",
+      "text": "Clean URLs and hosting",
+      "level": 2
+    },
+    {
+      "id": "dynamic-routes",
+      "text": "Dynamic routes",
+      "level": 2
+    },
+    {
+      "id": "data-loaders",
+      "text": "Data loaders",
+      "level": 2
+    },
+    {
+      "id": "current-limitations",
+      "text": "Current limitations",
+      "level": 2
+    }
+  ],
+  "relativePath": "guide/routing.md",
+  "lastUpdated": "2026-06-05T08:17:02.100Z"
+}

package/templates/docs/dist/preactpress-content/guide__what-is-preactpress.json

@@ -0,0 +1,51 @@
+{
+  "kind": "markdown",
+  "meta": {
+    "title": "What is PreactPress?",
+    "description": "Learn what PreactPress is and when to use it"
+  },
+  "html": "<h1 id=\"what-is-preactpress\" class=\"pp-heading\">What is PreactPress?<a class=\"pp-heading-anchor\" href=\"#what-is-preactpress\" aria-label=\"Link to this section\">#</a></h1>\n<p>PreactPress is a static site generator for fast, content-focused websites. You write pages in Markdown or MDX, configure navigation and theme options in <code>.preactpress/config.ts</code>, and PreactPress generates static HTML that can be deployed to any static host.</p>\n<p>It is built with <a href=\"https://vite.dev/\" target=\"_blank\" rel=\"noopener noreferrer\">Vite</a> and <a href=\"https://preactjs.com/\" target=\"_blank\" rel=\"noopener noreferrer\">Preact</a>. The workflow is inspired by VitePress, but the component model is Preact instead of Vue.</p>\n<h2 id=\"use-cases\" class=\"pp-heading\">Use cases<a class=\"pp-heading-anchor\" href=\"#use-cases\" aria-label=\"Link to this section\">#</a></h2>\n<h3 id=\"documentation\" class=\"pp-heading\">Documentation<a class=\"pp-heading-anchor\" href=\"#documentation\" aria-label=\"Link to this section\">#</a></h3>\n<p>PreactPress ships with a small default theme for technical documentation. It includes navigation, sidebar groups, outline links, search, last-updated metadata, and Markdown rendering out of the box.</p>\n<p>Use it when your docs live naturally as files:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span>index.md</span></span>\n<span class=\"line\"><span>guide/getting-started.md</span></span>\n<span class=\"line\"><span>guide/routing.md</span></span>\n<span class=\"line\"><span>reference/api.md</span></span></code></pre><p>Every Markdown or MDX file becomes a page, so documentation grows by adding files and linking them from the sidebar.</p>\n<h3 id=\"blogs-portfolios-and-marketing-sites\" class=\"pp-heading\">Blogs, portfolios, and marketing sites<a class=\"pp-heading-anchor\" href=\"#blogs-portfolios-and-marketing-sites\" aria-label=\"Link to this section\">#</a></h3>\n<p>PreactPress can also power blogs, portfolios, and small marketing sites. Markdown handles content, MDX brings in interactive Preact components, and custom themes let you replace the default documentation shell.</p>\n<p>The separate <code>preactpress-examples</code> project includes a custom-theme example that shows a magazine-style layout with article teasers and tag pages.</p>\n<h2 id=\"developer-experience\" class=\"pp-heading\">Developer experience<a class=\"pp-heading-anchor\" href=\"#developer-experience\" aria-label=\"Link to this section\">#</a></h2>\n<p>PreactPress focuses on keeping content work simple:</p>\n<table>\n<thead>\n<tr>\n<th>Feature</th>\n<th>What it gives you</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Vite dev server</td>\n<td>Fast startup and hot updates while editing content</td>\n</tr>\n<tr>\n<td>Markdown frontmatter</td>\n<td>Page titles, descriptions, tags, draft status, and social metadata</td>\n</tr>\n<tr>\n<td>MDX</td>\n<td>Preact components inside content pages</td>\n</tr>\n<tr>\n<td>Default theme</td>\n<td>Nav, sidebar, outline, search, footer, locale switcher</td>\n</tr>\n<tr>\n<td><code>preactpress check</code></td>\n<td>Config, route, and link validation before release</td>\n</tr>\n</tbody>\n</table>\n<p>For regular content, use <code>.md</code>. When a page needs interactivity, use <code>.mdx</code> and import a Preact component:</p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">import</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\"> Counter </span><span style=\"color:#D73A49;--shiki-dark:#F97583\">from</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> './components/Counter.tsx'</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold\">## Demo</span></span>\n<span class=\"line\"></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">&#x3C;</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">Counter</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\"> initial</span><span style=\"color:#D73A49;--shiki-dark:#F97583\">=</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">{</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\">3</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">} /></span></span></code></pre><h2 id=\"performance\" class=\"pp-heading\">Performance<a class=\"pp-heading-anchor\" href=\"#performance\" aria-label=\"Link to this section\">#</a></h2>\n<p>PreactPress produces static HTML for every route during the production build. The first visit receives HTML that already contains the page content, which is good for loading speed and SEO.</p>\n<p>After hydration, client-side navigation takes over. Markdown pages are loaded as small JSON payloads from <code>preactpress-content/*.json</code>, so large sites do not need to ship every Markdown body in the initial JavaScript bundle.</p>\n<p>The production output is static files only:</p>\n<table>\n<thead>\n<tr>\n<th>Output</th>\n<th>Purpose</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>index.html</code>, <code>*/index.html</code></td>\n<td>One HTML file per route</td>\n</tr>\n<tr>\n<td><code>assets/*</code></td>\n<td>Hashed JavaScript and CSS from Vite</td>\n</tr>\n<tr>\n<td><code>preactpress-search.json</code></td>\n<td>Search data for the default theme</td>\n</tr>\n<tr>\n<td><code>preactpress-content/*.json</code></td>\n<td>Lazy-loaded Markdown page payloads</td>\n</tr>\n<tr>\n<td><code>404.html</code></td>\n<td>Not-found page</td>\n</tr>\n</tbody>\n</table>\n<h2 id=\"what-about-vitepress\" class=\"pp-heading\">What about VitePress?<a class=\"pp-heading-anchor\" href=\"#what-about-vitepress\" aria-label=\"Link to this section\">#</a></h2>\n<p>If you know VitePress, PreactPress should feel familiar: both use Vite, file-based Markdown routing, a default docs theme, and static output.</p>\n<p>The main difference is the UI stack. VitePress uses Vue. PreactPress uses Preact and MDX, so interactive content and custom themes are written as Preact components.</p>\n<p>PreactPress is also static-only in production. You build the site once, upload the output directory, and serve it from Netlify, Vercel, Cloudflare Pages, GitHub Pages, S3, Nginx, or another static host.</p>\n<h2 id=\"next-steps\" class=\"pp-heading\">Next steps<a class=\"pp-heading-anchor\" href=\"#next-steps\" aria-label=\"Link to this section\">#</a></h2>\n<table>\n<thead>\n<tr>\n<th>Page</th>\n<th>Why</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><a href=\"/guide/getting-started\">Getting Started</a></td>\n<td>Install PreactPress and understand the starter structure</td>\n</tr>\n<tr>\n<td><a href=\"/guide/routing\">Routing</a></td>\n<td>Learn how files become URLs</td>\n</tr>\n<tr>\n<td><a href=\"/guide/deploy\">Deploy</a></td>\n<td>Build and publish a static site</td>\n</tr>\n</tbody>\n</table>\n",
+  "title": "What is PreactPress?",
+  "description": "Learn what PreactPress is and when to use it",
+  "tags": [],
+  "pageType": "website",
+  "headings": [
+    {
+      "id": "use-cases",
+      "text": "Use cases",
+      "level": 2
+    },
+    {
+      "id": "documentation",
+      "text": "Documentation",
+      "level": 3
+    },
+    {
+      "id": "blogs-portfolios-and-marketing-sites",
+      "text": "Blogs, portfolios, and marketing sites",
+      "level": 3
+    },
+    {
+      "id": "developer-experience",
+      "text": "Developer experience",
+      "level": 2
+    },
+    {
+      "id": "performance",
+      "text": "Performance",
+      "level": 2
+    },
+    {
+      "id": "what-about-vitepress",
+      "text": "What about VitePress?",
+      "level": 2
+    },
+    {
+      "id": "next-steps",
+      "text": "Next steps",
+      "level": 2
+    }
+  ],
+  "relativePath": "guide/what-is-preactpress.md",
+  "lastUpdated": "2026-06-04T07:32:52.322Z"
+}

package/templates/docs/dist/preactpress-content/markdown-examples.json

@@ -0,0 +1,71 @@
+{
+  "kind": "markdown",
+  "meta": {
+    "title": "Markdown examples",
+    "description": "Rendered examples of PreactPress Markdown extensions.",
+    "tags": [
+      "markdown"
+    ]
+  },
+  "html": "<h2 id=\"code-highlighting\" class=\"pp-heading\">Code highlighting<a class=\"pp-heading-anchor\" href=\"#code-highlighting\" aria-label=\"Link to this section\">#</a></h2>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> function</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\"> greet</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">(</span><span style=\"color:#E36209;--shiki-dark:#FFAB70\">name</span><span style=\"color:#D73A49;--shiki-dark:#F97583\">:</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\"> string</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">) {</span></span>\n<span class=\"line highlighted\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">  return</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> `Hello, ${</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">name</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">}!`</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><p>Inline code such as <code>themeConfig.outline</code> uses the theme’s code tokens.</p>\n<h2 id=\"snippet-import\" class=\"pp-heading\">Snippet import<a class=\"pp-heading-anchor\" href=\"#snippet-import\" aria-label=\"Link to this section\">#</a></h2>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">export</span><span style=\"color:#D73A49;--shiki-dark:#F97583\"> function</span><span style=\"color:#6F42C1;--shiki-dark:#B392F0\"> greet</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">(</span><span style=\"color:#E36209;--shiki-dark:#FFAB70\">name</span><span style=\"color:#D73A49;--shiki-dark:#F97583\">:</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\"> string</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">) {</span></span>\n<span class=\"line highlighted\"><span style=\"color:#D73A49;--shiki-dark:#F97583\">  return</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> `Hello, ${</span><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">name</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\">}!`</span></span>\n<span class=\"line\"><span style=\"color:#24292E;--shiki-dark:#E1E4E8\">}</span></span></code></pre><h2 id=\"containers-and-alerts\" class=\"pp-heading\">Containers and alerts<a class=\"pp-heading-anchor\" href=\"#containers-and-alerts\" aria-label=\"Link to this section\">#</a></h2>\n<div class=\"pp-container pp-container-tip\"><p class=\"pp-container-title\">TIP</p><div class=\"pp-container-body\"><p>Custom containers support <code>tip</code>, <code>warning</code>, <code>danger</code>, <code>info</code>, and <code>details</code>.</p>\n</div></div><div class=\"pp-container pp-container-note\"><p class=\"pp-container-title\">NOTE</p><div class=\"pp-container-body\"><p>GFM alert syntax is supported too.</p>\n</div></div><h2 id=\"table\" class=\"pp-heading\">Table<a class=\"pp-heading-anchor\" href=\"#table\" aria-label=\"Link to this section\">#</a></h2>\n<table>\n<thead>\n<tr>\n<th>Source</th>\n<th>Result</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code># Title</code></td>\n<td>Heading</td>\n</tr>\n<tr>\n<td>YAML frontmatter</td>\n<td>Page metadata</td>\n</tr>\n</tbody>\n</table>\n<h2 id=\"stable-heading\" class=\"pp-heading\">Stable heading<a class=\"pp-heading-anchor\" href=\"#stable-heading\" aria-label=\"Link to this section\">#</a></h2>\n<p>Use <code>{#id}</code> to control a heading fragment.</p>\n<h2 id=\"inline-table-of-contents\" class=\"pp-heading\">Inline table of contents<a class=\"pp-heading-anchor\" href=\"#inline-table-of-contents\" aria-label=\"Link to this section\">#</a></h2>\n<nav class=\"pp-inline-toc\" aria-label=\"Table of contents\"><a class=\"pp-inline-toc-link level-2\" href=\"#code-highlighting\">Code highlighting</a><a class=\"pp-inline-toc-link level-2\" href=\"#snippet-import\">Snippet import</a><a class=\"pp-inline-toc-link level-2\" href=\"#containers-and-alerts\">Containers and alerts</a><a class=\"pp-inline-toc-link level-2\" href=\"#table\">Table</a><a class=\"pp-inline-toc-link level-2\" href=\"#stable-heading\">Stable heading</a><a class=\"pp-inline-toc-link level-2\" href=\"#inline-table-of-contents\">Inline table of contents</a><a class=\"pp-inline-toc-link level-3\" href=\"#nested-section\">Nested section</a><a class=\"pp-inline-toc-link level-2\" href=\"#code-group\">Code group</a><a class=\"pp-inline-toc-link level-2\" href=\"#included-content\">Included content</a><a class=\"pp-inline-toc-link level-2\" href=\"#emoji-and-math\">Emoji and math</a></nav><h3 id=\"nested-section\" class=\"pp-heading\">Nested section<a class=\"pp-heading-anchor\" href=\"#nested-section\" aria-label=\"Link to this section\">#</a></h3>\n<p>The generated table of contents includes level-three headings.</p>\n<h2 id=\"code-group\" class=\"pp-heading\">Code group<a class=\"pp-heading-anchor\" href=\"#code-group\" aria-label=\"Link to this section\">#</a></h2>\n<div class=\"pp-code-group\"><input type=\"radio\" name=\"pp-cg-1\" id=\"pp-cg-1-0\" class=\"pp-code-group-input\" checked><label for=\"pp-cg-1-0\" class=\"pp-code-group-tab\">pnpm</label><input type=\"radio\" name=\"pp-cg-1\" id=\"pp-cg-1-1\" class=\"pp-code-group-input\"><label for=\"pp-cg-1-1\" class=\"pp-code-group-tab\">npm</label><div class=\"pp-code-group-blocks\"><div class=\"pp-code-group-block\"><pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">pnpm</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> add</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\"> -D</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> preactpress</span></span></code></pre></div><div class=\"pp-code-group-block\"><pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6F42C1;--shiki-dark:#B392F0\">npm</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> install</span><span style=\"color:#005CC5;--shiki-dark:#79B8FF\"> --save-dev</span><span style=\"color:#032F62;--shiki-dark:#9ECBFF\"> preactpress</span></span></code></pre></div></div></div><h2 id=\"included-content\" class=\"pp-heading\">Included content<a class=\"pp-heading-anchor\" href=\"#included-content\" aria-label=\"Link to this section\">#</a></h2>\n<div class=\"pp-container pp-container-tip\"><p class=\"pp-container-title\">Shared fragment</p><div class=\"pp-container-body\"><p>This note is pulled in via <code>&lt;!-- include cycle detected: /home/watzak/master/kamod/preactpress/templates/docs/partials/shared-note.md --&gt;</code>.</p>\n</div></div><h2 id=\"emoji-and-math\" class=\"pp-heading\">Emoji and math<a class=\"pp-heading-anchor\" href=\"#emoji-and-math\" aria-label=\"Link to this section\">#</a></h2>\n<p>This starter enables both options: 🚀</p>\n<p>Inline math: \n    <span id=\"mjx-a543d31\">\n      <style>\n      #mjx-a543d31{\n        display:contents;\n        mjx-assistive-mml {\n          user-select: text !important;\n          clip: auto !important;\n          color: rgba(0,0,0,0);\n        }\n        \nmjx-container[jax=\"SVG\"] {\n  direction: ltr;\n}\n\nmjx-container[jax=\"SVG\"] > svg {\n  overflow: visible;\n  min-height: 1px;\n  min-width: 1px;\n}\n\nmjx-container[jax=\"SVG\"] > svg a {\n  fill: blue;\n  stroke: blue;\n}\n\nmjx-assistive-mml {\n  position: absolute !important;\n  top: 0px;\n  left: 0px;\n  clip: rect(1px, 1px, 1px, 1px);\n  padding: 1px 0px 0px 0px !important;\n  border: 0px !important;\n  display: block !important;\n  width: auto !important;\n  overflow: hidden !important;\n  -webkit-touch-callout: none;\n  -webkit-user-select: none;\n  -khtml-user-select: none;\n  -moz-user-select: none;\n  -ms-user-select: none;\n  user-select: none;\n}\n\nmjx-assistive-mml[display=\"block\"] {\n  width: 100% !important;\n}\n\nmjx-container[jax=\"SVG\"][display=\"true\"] {\n  display: block;\n  text-align: center;\n  margin: 1em 0;\n}\n\nmjx-container[jax=\"SVG\"][display=\"true\"][width=\"full\"] {\n  display: flex;\n}\n\nmjx-container[jax=\"SVG\"][justify=\"left\"] {\n  text-align: left;\n}\n\nmjx-container[jax=\"SVG\"][justify=\"right\"] {\n  text-align: right;\n}\n\ng[data-mml-node=\"merror\"] > g {\n  fill: red;\n  stroke: red;\n}\n\ng[data-mml-node=\"merror\"] > rect[data-background] {\n  fill: yellow;\n  stroke: none;\n}\n\ng[data-mml-node=\"mtable\"] > line[data-line], svg[data-table] > g > line[data-line] {\n  stroke-width: 70px;\n  fill: none;\n}\n\ng[data-mml-node=\"mtable\"] > rect[data-frame], svg[data-table] > g > rect[data-frame] {\n  stroke-width: 70px;\n  fill: none;\n}\n\ng[data-mml-node=\"mtable\"] > .mjx-dashed, svg[data-table] > g > .mjx-dashed {\n  stroke-dasharray: 140;\n}\n\ng[data-mml-node=\"mtable\"] > .mjx-dotted, svg[data-table] > g > .mjx-dotted {\n  stroke-linecap: round;\n  stroke-dasharray: 0,140;\n}\n\ng[data-mml-node=\"mtable\"] > g > svg {\n  overflow: visible;\n}\n\n[jax=\"SVG\"] mjx-tool {\n  display: inline-block;\n  position: relative;\n  width: 0;\n  height: 0;\n}\n\n[jax=\"SVG\"] mjx-tool > mjx-tip {\n  position: absolute;\n  top: 0;\n  left: 0;\n}\n\nmjx-tool > mjx-tip {\n  display: inline-block;\n  padding: .2em;\n  border: 1px solid #888;\n  font-size: 70%;\n  background-color: #F8F8F8;\n  color: black;\n  box-shadow: 2px 2px 5px #AAAAAA;\n}\n\ng[data-mml-node=\"maction\"][data-toggle] {\n  cursor: pointer;\n}\n\nmjx-status {\n  display: block;\n  position: fixed;\n  left: 1em;\n  bottom: 1em;\n  min-width: 25%;\n  padding: .2em .4em;\n  border: 1px solid #888;\n  font-size: 90%;\n  background-color: #F8F8F8;\n  color: black;\n}\n\nforeignObject[data-mjx-xml] {\n  font-family: initial;\n  line-height: normal;\n  overflow: visible;\n}\n\nmjx-container[jax=\"SVG\"] path[data-c], mjx-container[jax=\"SVG\"] use[data-c] {\n  stroke-width: 3;\n}\n\ng[data-mml-node=\"xypic\"] path {\n  stroke-width: inherit;\n}\n\n.MathJax g[data-mml-node=\"xypic\"] path {\n  stroke-width: inherit;\n}\n\n      }\n      </style>\n      <mjx-container class=\"MathJax\" jax=\"SVG\" style=\"position: relative;\"><svg style=\"vertical-align: -0.186ex;\" xmlns=\"http://www.w3.org/2000/svg\" width=\"8.699ex\" height=\"2.072ex\" role=\"img\" focusable=\"false\" viewBox=\"0 -833.9 3845.1 915.9\" aria-hidden=\"true\"><g stroke=\"currentColor\" fill=\"currentColor\" stroke-width=\"0\" transform=\"scale(1,-1)\"><g data-mml-node=\"math\"><g data-mml-node=\"mi\"><path data-c=\"1D438\" d=\"M492 213Q472 213 472 226Q472 230 477 250T482 285Q482 316 461 323T364 330H312Q311 328 277 192T243 52Q243 48 254 48T334 46Q428 46 458 48T518 61Q567 77 599 117T670 248Q680 270 683 272Q690 274 698 274Q718 274 718 261Q613 7 608 2Q605 0 322 0H133Q31 0 31 11Q31 13 34 25Q38 41 42 43T65 46Q92 46 125 49Q139 52 144 61Q146 66 215 342T285 622Q285 629 281 629Q273 632 228 634H197Q191 640 191 642T193 659Q197 676 203 680H757Q764 676 764 669Q764 664 751 557T737 447Q735 440 717 440H705Q698 445 698 453L701 476Q704 500 704 528Q704 558 697 578T678 609T643 625T596 632T532 634H485Q397 633 392 631Q388 629 386 622Q385 619 355 499T324 377Q347 376 372 376H398Q464 376 489 391T534 472Q538 488 540 490T557 493Q562 493 565 493T570 492T572 491T574 487T577 483L544 351Q511 218 508 216Q505 213 492 213Z\"></path></g><g data-mml-node=\"mo\" transform=\"translate(1041.8,0)\"><path data-c=\"3D\" d=\"M56 347Q56 360 70 367H707Q722 359 722 347Q722 336 708 328L390 327H72Q56 332 56 347ZM56 153Q56 168 72 173H708Q722 163 722 153Q722 140 707 133H70Q56 140 56 153Z\"></path></g><g data-mml-node=\"mi\" transform=\"translate(2097.6,0)\"><path data-c=\"1D45A\" d=\"M21 287Q22 293 24 303T36 341T56 388T88 425T132 442T175 435T205 417T221 395T229 376L231 369Q231 367 232 367L243 378Q303 442 384 442Q401 442 415 440T441 433T460 423T475 411T485 398T493 385T497 373T500 364T502 357L510 367Q573 442 659 442Q713 442 746 415T780 336Q780 285 742 178T704 50Q705 36 709 31T724 26Q752 26 776 56T815 138Q818 149 821 151T837 153Q857 153 857 145Q857 144 853 130Q845 101 831 73T785 17T716 -10Q669 -10 648 17T627 73Q627 92 663 193T700 345Q700 404 656 404H651Q565 404 506 303L499 291L466 157Q433 26 428 16Q415 -11 385 -11Q372 -11 364 -4T353 8T350 18Q350 29 384 161L420 307Q423 322 423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 181Q151 335 151 342Q154 357 154 369Q154 405 129 405Q107 405 92 377T69 316T57 280Q55 278 41 278H27Q21 284 21 287Z\"></path></g><g data-mml-node=\"msup\" transform=\"translate(2975.6,0)\"><g data-mml-node=\"mi\"><path data-c=\"1D450\" d=\"M34 159Q34 268 120 355T306 442Q362 442 394 418T427 355Q427 326 408 306T360 285Q341 285 330 295T319 325T330 359T352 380T366 386H367Q367 388 361 392T340 400T306 404Q276 404 249 390Q228 381 206 359Q162 315 142 235T121 119Q121 73 147 50Q169 26 205 26H209Q321 26 394 111Q403 121 406 121Q410 121 419 112T429 98T420 83T391 55T346 25T282 0T202 -11Q127 -11 81 37T34 159Z\"></path></g><g data-mml-node=\"mn\" transform=\"translate(466,363) scale(0.707)\"><path data-c=\"32\" d=\"M109 429Q82 429 66 447T50 491Q50 562 103 614T235 666Q326 666 387 610T449 465Q449 422 429 383T381 315T301 241Q265 210 201 149L142 93L218 92Q375 92 385 97Q392 99 409 186V189H449V186Q448 183 436 95T421 3V0H50V19V31Q50 38 56 46T86 81Q115 113 136 137Q145 147 170 174T204 211T233 244T261 278T284 308T305 340T320 369T333 401T340 431T343 464Q343 527 309 573T212 619Q179 619 154 602T119 569T109 550Q109 549 114 549Q132 549 151 535T170 489Q170 464 154 447T109 429Z\"></path></g></g></g></g></svg><mjx-assistive-mml unselectable=\"on\" display=\"inline\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><mi>E</mi><mo>=</mo><mi>m</mi><msup><mi>c</mi><mn>2</mn></msup></math></mjx-assistive-mml></mjx-container>\n    </span>\n  </p>\n",
+  "title": "Markdown examples",
+  "description": "Rendered examples of PreactPress Markdown extensions.",
+  "tags": [
+    "markdown"
+  ],
+  "pageType": "website",
+  "headings": [
+    {
+      "id": "code-highlighting",
+      "text": "Code highlighting",
+      "level": 2
+    },
+    {
+      "id": "snippet-import",
+      "text": "Snippet import",
+      "level": 2
+    },
+    {
+      "id": "containers-and-alerts",
+      "text": "Containers and alerts",
+      "level": 2
+    },
+    {
+      "id": "table",
+      "text": "Table",
+      "level": 2
+    },
+    {
+      "id": "stable-heading",
+      "text": "Stable heading",
+      "level": 2
+    },
+    {
+      "id": "inline-table-of-contents",
+      "text": "Inline table of contents",
+      "level": 2
+    },
+    {
+      "id": "nested-section",
+      "text": "Nested section",
+      "level": 3
+    },
+    {
+      "id": "code-group",
+      "text": "Code group",
+      "level": 2
+    },
+    {
+      "id": "included-content",
+      "text": "Included content",
+      "level": 2
+    },
+    {
+      "id": "emoji-and-math",
+      "text": "Emoji and math",
+      "level": 2
+    }
+  ],
+  "relativePath": "markdown-examples.md",
+  "lastUpdated": "2026-06-08T15:16:59.431Z"
+}

package/templates/docs/dist/preactpress-content/tags__markdown.json

@@ -0,0 +1,16 @@
+{
+  "kind": "markdown",
+  "meta": {
+    "tagIndex": true,
+    "tag": "markdown",
+    "tagSlug": "markdown"
+  },
+  "html": "<article class=\"pp-tag-index\"><h1 class=\"pp-heading\" id=\"tag-markdown\">Pages tagged: markdown</h1><p class=\"pp-tag-index-count\">1 page(s).</p><ul class=\"pp-tag-index-list\">\n  <li><a href=\"/markdown-examples\">Markdown examples</a></li>\n</ul></article>",
+  "title": "Tag: markdown",
+  "description": "Pages tagged “markdown”",
+  "tags": [
+    "markdown"
+  ],
+  "pageType": "website",
+  "headings": []
+}

package/templates/docs/dist/preactpress-search.json

@@ -0,0 +1,166 @@
+[
+  {
+    "route": "/",
+    "locale": "root",
+    "title": "PreactPress",
+    "description": "Build static documentation and content sites with Markdown, MDX, Vite, and Preact.",
+    "excerpt": "PreactPress generates deployable HTML and assets. No Node server is required in production.",
+    "tags": []
+  },
+  {
+    "route": "/about",
+    "locale": "root",
+    "title": "About",
+    "description": "About this site",
+    "excerpt": "About us # Your content here. This page was added as part of the Your first 5 minutes tutorial. Replace this text with your own copy — team bio, project…",
+    "tags": []
+  },
+  {
+    "route": "/de",
+    "locale": "de",
+    "title": "PreactPress auf Deutsch",
+    "description": "Kleine deutschsprachige i18n-Demo für PreactPress.",
+    "excerpt": "",
+    "tags": []
+  },
+  {
+    "route": "/de/guide/getting-started",
+    "locale": "de",
+    "title": "Erste Schritte",
+    "description": "PreactPress installieren und lokal starten.",
+    "excerpt": "Projekt erstellen # mkdir meine-seite cd meine-seite pnpm dlx preactpress init pnpm install pnpm run dev Öffne danach http://localhost:5173 . Nächste…",
+    "tags": []
+  },
+  {
+    "route": "/de/guide/what-is-preactpress",
+    "locale": "de",
+    "title": "Was ist PreactPress?",
+    "description": "Kurze Einführung in den statischen Site-Generator.",
+    "excerpt": "PreactPress erzeugt statische Websites aus Markdown und MDX. Die Entwicklung läuft mit Vite, Layouts werden mit Preact gebaut, und das Ergebnis kann auf…",
+    "tags": []
+  },
+  {
+    "route": "/guide/advanced",
+    "locale": "root",
+    "title": "Advanced APIs",
+    "description": "Build hooks, data loaders, dynamic routes, MPA mode, and incremental builds.",
+    "excerpt": "Async configuration # Export an async factory when navigation or metadata comes from another system. import { defineConfig } from 'preactpress/config'…",
+    "tags": []
+  },
+  {
+    "route": "/guide/commands",
+    "locale": "root",
+    "title": "CLI and validation",
+    "description": "Commands for scaffolding, development, validation, builds, and previews.",
+    "excerpt": "Run commands from the site root or pass a root path as the final argument. Command Purpose preactpress init [dir] Scaffold the minimal starter preactpress…",
+    "tags": []
+  },
+  {
+    "route": "/guide/configuration",
+    "locale": "root",
+    "title": "Configuration reference",
+    "description": "Complete reference for PreactPress site, theme, Markdown, build, and hook options.",
+    "excerpt": "Configuration lives in .preactpress/config.ts . A plain object works without imports; defineConfig adds type inference once PreactPress is installed.…",
+    "tags": []
+  },
+  {
+    "route": "/guide/creating-pages",
+    "locale": "root",
+    "title": "Creating pages",
+    "description": "Add new Markdown and MDX pages, understand URLs, and wire them into navigation",
+    "excerpt": "Creating pages # PreactPress builds pages from files — there is no separate page editor or CMS. Every .md or .mdx file under the source directory ( srcDir…",
+    "tags": []
+  },
+  {
+    "route": "/guide/custom-themes",
+    "locale": "root",
+    "title": "Custom themes",
+    "description": "Replace the default shell with a Preact layout.",
+    "excerpt": "Set theme to a TSX module relative to .preactpress : export default { theme: './theme/Layout.tsx' } The module default-exports a Preact component…",
+    "tags": []
+  },
+  {
+    "route": "/guide/default-theme",
+    "locale": "root",
+    "title": "Default theme",
+    "description": "Configure navigation, sidebars, search, locales, and responsive behavior.",
+    "excerpt": "The bundled theme provides a responsive header, mobile drawer, sidebar, page outline, local or Algolia search, dark mode, tags, previous/next links, edit…",
+    "tags": []
+  },
+  {
+    "route": "/guide/deploy",
+    "locale": "root",
+    "title": "Deploy",
+    "description": "Build and publish a PreactPress site",
+    "excerpt": "Deploy # PreactPress builds static files. Production deployment means running a build and uploading the output directory, usually dist/ , to a static…",
+    "tags": []
+  },
+  {
+    "route": "/guide/first-five-minutes",
+    "locale": "root",
+    "title": "Your first 5 minutes",
+    "description": "Change the site title, add a page, and update navigation",
+    "excerpt": "Your first 5 minutes # This hands-on tutorial follows the setup overview in Getting Started . Follow the steps below in your project — this site is the…",
+    "tags": []
+  },
+  {
+    "route": "/guide/getting-started",
+    "locale": "root",
+    "title": "Getting Started",
+    "description": "Install PreactPress and start a new documentation site",
+    "excerpt": "Getting Started # This guide shows how to create a PreactPress site, understand the generated files, and start the development server. Prerequisites # You…",
+    "tags": []
+  },
+  {
+    "route": "/guide/markdown-and-mdx",
+    "locale": "root",
+    "title": "Markdown and MDX",
+    "description": "Author static Markdown pages and interactive MDX pages.",
+    "excerpt": "Use .md for content that does not need browser-side components. Use .mdx when a page imports and renders Preact components. Markdown # Markdown pages…",
+    "tags": []
+  },
+  {
+    "route": "/guide/routing",
+    "locale": "root",
+    "title": "Routing",
+    "description": "Understand how PreactPress maps files to URLs",
+    "excerpt": "Routing # PreactPress uses file-based routing. Every .md and .mdx file under srcDir becomes a route, and production builds write each route as static…",
+    "tags": []
+  },
+  {
+    "route": "/guide/what-is-preactpress",
+    "locale": "root",
+    "title": "What is PreactPress?",
+    "description": "Learn what PreactPress is and when to use it",
+    "excerpt": "What is PreactPress? # PreactPress is a static site generator for fast, content-focused websites. You write pages in Markdown or MDX, configure navigation…",
+    "tags": []
+  },
+  {
+    "route": "/interactive",
+    "locale": "root",
+    "title": "Interactive MDX",
+    "description": "Markdown with imported Preact components",
+    "excerpt": "Markdown with imported Preact components",
+    "tags": []
+  },
+  {
+    "route": "/markdown-examples",
+    "locale": "root",
+    "title": "Markdown examples",
+    "description": "Rendered examples of PreactPress Markdown extensions.",
+    "excerpt": "Code highlighting # export function greet ( name : string ) { return `Hello, ${ name }!` } Inline code such as themeConfig.outline uses the theme’s code…",
+    "tags": [
+      "markdown"
+    ]
+  },
+  {
+    "route": "/tags/markdown",
+    "locale": "root",
+    "title": "Tag: markdown",
+    "description": "Pages tagged “markdown”",
+    "excerpt": "Pages tagged: markdown 1 page(s). Markdown examples",
+    "tags": [
+      "markdown"
+    ]
+  }
+]

package/templates/docs/dist/preactpress-theme.js

@@ -0,0 +1 @@
+(function(){try{var k="preactpress-theme";var m=localStorage.getItem(k);if(m==='light'||m==='dark')document.documentElement.setAttribute('data-theme',m);}catch(e){}})();