Guides

Authoring Docs

Structure chapters, callouts, and technical examples so dense content stays readable.

Chapter structure

Start every page with a short framing paragraph. Makimono assumes the reader lands mid-stream from search, changelog links, or a shared anchor.

Headings and local navigation

Use h2 and h3 headings consistently. The local table of contents automatically indexes those levels and highlights the current section as the reader scrolls.

Code examples

Keep code blocks short and purpose-specific. The theme wraps each block with a copy button on page load.

{
  "title": "Authoring Docs",
  "patterns": ["short lead", "clear headings", "copyable code"]
}