All of your site's content lives in the content/ folder. Every page is a plain Markdown file. This post walks through each one.
_site.md
content/_site.md is the only required file. It controls:
- The site title, description, and owner (used in
<meta>tags) - The active theme
- Which file to use as the homepage (
index) - The navbar links (
# Navigationsection)
Open it and fill in your details before anything else.
Page Files
| File | Purpose |
|---|---|
about.md |
About page |
blog.md |
Blog index |
contact.md |
Contact page |
store.md |
Store index |
gallery.md |
Gallery index |
Each file has a small frontmatter block at the top:
---
title: About
visibility: public
---
visibility controls whether the page is published. Use public, draft, or private.
Frontmatter Reference
| Field | Used in | Description |
|---|---|---|
title |
All pages | Page title used in <title> and headings |
description |
All pages | Short summary for search engines |
visibility |
All pages | public / draft / private / archive |
actionEmail |
contact.md |
Where the contact form sends submissions |
date |
Blog posts | Publication date (yyyy-mm-dd) |
seriesTitle |
Blog posts | Groups posts into a named series |
seriesEntry |
Blog posts | Position within the series (number) |
image |
Blog posts, products | Path to a cover image |
price |
Store products | Display price (e.g. $24.99) |
Visibility States
| Value | Behavior |
|---|---|
public |
Included in build and visible to all |
draft |
Excluded from production build |
private |
Excluded from build entirely |
archive |
Included but excluded from indexes and feeds |
deleted |
Excluded; treated as removed |