New: search page at /blog/search, JSON feed at /feed.json, and machine-readable search at /blog/search.json.
Back to blog
Engineering 1 minute read

A Markdown Pipeline That Looks Like Product UI

February 1, 2026

A Markdown Pipeline That Looks Like Product UI

AI SUMMARY

Use mdsvex with `remark-gfm` (tables), `rehype-slug` + `rehype-autolink-headings` (deep links), and `@shikijs/rehype` (syntax highlighting with dual themes). Style `pre.shiki` with balanced padding, radius, and line height.

Alex Kim
Alex Kim
Product Engineer
View author page

Share this article

On this page

There are two failure modes for Markdown blogs:

  1. Everything looks like a generic “prose” template.
  2. Code blocks are unreadable in either light or dark mode.

Tables (GFM)

PluginWhy
remark-gfmtables, strikethrough, task lists

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" } }]
]
Series

SvelteKit Publishing System

A multi-part track covering the content pipeline, presentation layer, and delivery mechanics for a modern SvelteKit publication.

View series page

More from this author

Alex Kim

Author page

More posts to read