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 ## Frontmatter above 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

  1. Footnotes come from goldmark’s extension set, enabled in internal/build/markdown.go↩︎