A blank page is the slowest way to start writing. Templates give you the shape and let you replace the words.
Page templates#
When you create a file, pick a template:
| Template | Good for |
|---|---|
| Blank | A plain heading. The default |
| Guide / How-to | Step-by-step instructions with prerequisites |
| Blog post | Dated post with front matter filled in |
| FAQ | Question-and-answer pairs |
| API reference | Endpoint, parameters, example, response |
| Changelog | Versioned entries, newest first |
Site templates#
When you create a new collection, you can scaffold the whole folder:
| Template | What you get |
|---|---|
| Starter | A config, a table of contents, one welcome page |
| Documentation site | Introduction, getting started, guides, reference |
| Blog | An about page and a first post |
| Handbook / KB | Welcome, how we work, policies, FAQ |
| Product / landing | Overview, features, FAQ |
Each arrives with a _config.md already set to a theme that suits it, a
_toc.md in a sensible order, and pages you can rewrite.
Tip
Templates are only a starting point — every file they create is an ordinary Markdown file you can rename, reorder or delete.