HoursMon – Fri 7:30am – 5:00pm

Writing docs

How documentation pages are organised in Grav.

Updated 15 Nov 2026 · gravmarkdown

Folder structure

Every folder under pages/02.docs/ becomes a page. Numbered prefixes set the order in the sidebar.

pages/02.docs/
  docs.md                 ← landing page (template: docs)
  01.get-started/
    default.md
    01.installation/default.md

Callouts

Use a plain HTML block in your Markdown:

<div class="callout callout-tip"><strong>Tip</strong> Your text.</div>

Variants: callout-tip, callout-info, callout-warning, callout-danger.

Page options

  • description: shows under the title, in the sidebar and on cards.
  • toc: false hides the "On this page" list.
  • hide_children: true hides the child-page cards.