Language Den
Blog

Blog

How to add a post

This sample post exists so the blog has something to show. Delete it once you have your own writing.

Frontmatter

Each file in app/content/blog/ is named YYYY-MM-DD-slug.md. The slug in the filename is the URL. Required YAML fields are title, date, and description. Optional fields:

  • tags: a list. Each one gets a page at /blog/tags/:tag.
  • published: defaults to true. Set false to keep a draft in git without serving it.
  • og_image: path for that post's share image. Falls back to the site default.

A date in the future is treated as unpublished. A complete header looks like this:

---
title: How to add a post
date: 2026-08-23
description: Drop a markdown file in the repo and it shows up on the blog.
tags:
  - launchpad
published: true
---

Images

Put files in app/assets/images/blog/ and reference them by filename:

A tiny sample image for the lightbox

Relative images are rewritten to the digested asset path and open in the marketing lightbox.

Publishing

The blog is on by default. Set BLOG_ENABLED=false in .env (and in production secrets) to hide it: nav, sitemap, and /blog.rss disappear, and the routes 404.