← Back to blog

Writing Posts in Markdown and MDX

1 min read
  • mdx
  • guide
Cover image for Writing Posts in Markdown and MDX

Every post here is written in MDX — markdown with the option to drop in components when you need them. Here's a tour of what's supported.

Text formatting

You get the usual: bold, italic, strikethrough, and inline code. Links work too, both external and internal.

Lists

  1. Ordered lists
  2. Are handy for steps
  3. Like this one
  • And unordered lists
  • For everything else
    • Including nested items

Code with syntax highlighting

Fenced code blocks are highlighted at build time with Shiki:

export function greet(name: string): string {
  return `Hello, ${name}!`;
}
 
console.log(greet("world"));

Tables

FeatureSupportedNotes
HeadingsYesWith auto anchor links
Code blocksYesShiki highlighting
TablesYesVia GitHub-flavored md
FootnotesYesAlso via GFM

Blockquotes

Markdown keeps the writing experience close to plain text, which is exactly what you want when the goal is to write more often.

That's most of it. Now go write something.