Markdown
Every .md file in content/ becomes a page. content/index.md is the site index; content/<name>.md becomes <name>/index.html, so its URL always ends in a slash.
Frontmatter
The header is TOML between +++ fences, parsed into the same typed structs the rest of the configuration uses:
+++
title = "Markdown"
description = "Shown in the document meta description."
+++
What is enabled
- GitHub Flavored Markdown: tables, strikethrough, task lists, autolinks
- Footnotes1
- Typographer substitutions – like this one
- Automatic heading IDs, so
## Frontmatterabove is linkable
Code blocks are rendered as plain <pre><code>, styled by the theme. Highlighting, if it is ever added, happens at build time: this generator ships zero highlighting JavaScript.
| Layer | Source |
|---|---|
| reset | embedded in the binary |
| tokens | themes/<theme>/tokens.css |
| brand | themes/<theme>/brand.css |
| site | sites/<slug>/assets/*.css |
-
Footnotes come from goldmark’s extension set, enabled in
internal/build/markdown.go. ↩︎