Publishing from Markdown
This post is a starter draft. Edit or replace it before treating the site as launched.
A new piece is a Markdown file in this repository:
- Blog:
src/content/blog/your-slug.md - Showcase:
src/content/showcase/your-slug.md
Frontmatter is the only required structure: a title, a date, and an optional excerpt or summary. The body can be as free-form as the work requires. Files whose names start with _ are templates and are not published. Set draft: true to keep a piece off the production build while still previewing it locally.
Drafting can happen with an AI agent. The file in git is the published artifact; nothing goes live until that file is committed and the site is rebuilt. That keeps editorial control on the same surface as the rest of the project.