Docsify Template

Decision Trees

"I need to create or modify a component"

Component task?
├─ Create new component from scratch
│  └─ references/components/patterns.md (creation checklist)
├─ Modify existing component HTML/behavior
│  └─ references/components/api.md (all YAML schemas + HTML patterns)
├─ Fix component not rendering
│  └─ references/components/gotchas.md (registry, YAML escaping)
├─ Add interactivity (collapsibles, search, toggles)
│  └─ references/components/patterns.md (interactivity patterns)
└─ Understand how components work end-to-end
   └─ references/components/REFERENCE.md (pipeline overview)

"I need to modify plugins or the rendering pipeline"

Plugin task?
├─ Understand the 3-hook lifecycle
│  └─ references/plugins/REFERENCE.md (beforeEach → afterEach → doneEach)
├─ Change how frontmatter/tabs work
│  └─ references/plugins/api.md (component-renderer.js internals)
├─ Change tab switching behavior
│  └─ references/plugins/api.md (htmx-virtual.js section)
├─ Modify LaTeX export
│  └─ references/plugins/configuration.md (latex-export + pandoc.wasm)
├─ Add a new plugin
│  └─ references/plugins/patterns.md (plugin creation pattern)
└─ Debug plugin issues (rendering, ordering, conflicts)
   └─ references/plugins/gotchas.md

"I need to change styles or rebrand"

Styling task?
├─ Rebrand (change colors for a new project)
│  └─ references/styling/patterns.md (rebranding checklist)
├─ Modify specific component styles
│  └─ references/styling/api.md (all CSS custom properties)
├─ Change typography, spacing, or layout
│  └─ references/styling/api.md (typography + spacing tokens)
├─ Understand warm vs cool zones
│  └─ references/styling/REFERENCE.md (two-temperature design)
├─ Add responsive or print styles
│  └─ references/styling/patterns.md
└─ Fix visual bugs (overflow, z-index, mobile)
   └─ references/styling/gotchas.md

"I need to write or organize content"

Content task?
├─ Create a new documentation page
│  └─ references/authoring/patterns.md (page templates)
├─ Add components to a page (YAML code fences)
│  └─ references/authoring/api.md (component usage in markdown)
├─ Create tabbed page (Quick Start / Technical)
│  └─ references/authoring/configuration.md (frontmatter + headings)
├─ Add page to sidebar navigation
│  └─ references/authoring/configuration.md (sidebar format)
├─ Use mermaid diagrams or region toggles
│  └─ references/authoring/api.md (special content types)
└─ Fix content not rendering / blank page
   └─ references/authoring/gotchas.md

"I need to create or modify export filters, templates, or formats"

Export task?
├─ Create a new Lua filter (new output format)
│  └─ references/export/patterns.md (filter creation pattern)
├─ Create a new LaTeX template (new branding)
│  └─ references/export/patterns.md (template creation)
├─ Add a new format to the Export dropdown
│  └─ references/export/configuration.md (FORMAT_DEFS)
├─ Modify how a component renders in LaTeX/LLM
│  └─ references/export/api.md (renderer functions + component_map)
├─ Rebrand the PDF output (colors, header, logo)
│  └─ references/export/configuration.md (brand colors mapping)
├─ Understand the export pipeline end-to-end
│  └─ references/export/REFERENCE.md (architecture + pattern)
├─ Fix export producing empty output or errors
│  └─ references/export/gotchas.md (API gotchas, $ escaping)
├─ Add a new component to existing filters
│  └─ references/export/patterns.md (adding components to all filters)
└─ Update Pandoc WASM version
   └─ references/export/configuration.md (pandoc.wasm setup)

Product Index

Troubleshooting Index

Key Globals