There are two failure modes for Markdown blogs:
- Everything looks like a generic “prose” template.
- Code blocks are unreadable in either light or dark mode.
Tables (GFM)
| Plugin | Why |
|---|---|
remark-gfm | tables, strikethrough, task lists |
Headings you can link to
We add ids and autolink headings so every section is shareable.
Shiki, dual theme
Documentation-style code blocks use different themes in light vs dark. We do the same.
// svelte.config.js
rehypePlugins: [
[rehypeShiki, { themes: { light: "one-light", dark: "github-dark-default" } }]
]