Rebuilding the Blog
meta markdown devops
Rebuilding the Blog
This blog is now fully file-driven. There's no registry to maintain — every .md
file under contents/blogs/ (at any folder depth) becomes a post automatically.
How it works
- The route slug is just the filename without
.md. Sowelcome.mdlives at/blog/welcome. - All metadata lives in the frontmatter block at the top of the file:
---
title: Rebuilding the Blog
date: 2026-06-22
description: A short summary shown in the list.
tags: [meta, markdown, devops]
---
- Posts are sorted by
date, newest first.
Drop a file in
contents/blogs/, give it frontmatter, done. No JSON to edit.
What renders
Everything GitHub-flavored markdown supports — inline code, bold, italic,
tables, task lists, blockquotes, and fenced code with syntax highlighting.
| Feature | Supported |
|---|---|
| Code blocks | ✅ |
| Tables | ✅ |
| Mermaid | ✅ |
| Task lists | ✅ |
- frontmatter metadata
- recursive discovery
- write more posts