January 1, 2026 · By David

Example Post

example

This file is just documentation, written as a real post so you can see exactly how it renders.

Frontmatter fields

  • title (required) — shows as the page title and on the post card.
  • description (required) — the excerpt shown on cards and used for SEO/social sharing.
  • date (required) — format YYYY-MM-DD. Posts are sorted newest-first automatically.
  • author (optional, defaults to "David") — shown next to the date on the post page.
  • tags (optional) — a list of short labels shown on the card and post page. Just for display, not clickable/filterable.
  • image (optional) — a featured photo. Put the image file in the same folder as this markdown file, then reference it with a relative path like ./cover.jpg. If you skip this, the card just shows a plain color block instead.
  • draft (optional, defaults to false) — set to true to keep a post out of the live site while you’re still writing it. This example file has draft: true, which is why it won’t actually appear on the blog.
  • translationKey (optional) — give the same value to the matching post in another language (e.g. the German or Spanish translation of this exact post) and the language switcher on that post will link straight to it instead of just the generic blog listing. Leave it out if a post has no translation.

Filenames become URLs

Name files like 2026-01-15_my-post-title.md — the leading date is stripped from the URL automatically, so this becomes /blog/my-post-title, not /blog/2026-01-15_my-post-title. The date prefix is just there to help you sort/organize files on disk (and pick out the right one at a glance); it has nothing to do with the date field above, which is what actually controls sort order and the displayed date. You can also just name a file my-post-title.md with no date prefix at all — it works exactly the same, the slug just is the filename either way.

This example file happens to be named example-post.md (no date prefix), so it would live at /blog/example-post.

Everything else is normal Markdown

Bold, italic, links, lists, blockquotes, and images all work normally inside the body.

A blockquote looks like this.

  • bullet one
  • bullet two