Writing Guide: MDX on This Site

This post shows the formatting you can use in posts.

Frontmatter

Every post starts with a frontmatter block:

title: 'Post title'
publishedAt: '2026-09-29'
summary: 'One-line summary'
image: '/optional-cover.png' # optional, overrides the generated OG image
lang: 'zh' # optional, set for posts not written in English

Setting lang: 'zh' marks the post as Chinese, so browsers and screen readers use the right fonts and pronunciation.

Text

Paragraphs, bold, italic, strikethrough, inline code, internal links, and external links. External links open in a new tab.

Lists

1. First ordered item
2. Second ordered item

• Unordered item

• Another item

• Launch the blog

• Write the hundredth post

Quotes

Learning without thought is labor lost; thought without learning is perilous.

Code

Code blocks are highlighted with sugar-high:

function greet(name) {
  return `Hello, ${name}!`
}

console.log(greet('Suosi'))

Tables

Heading anchors

Every heading gets an anchor. Hover over a heading to reveal #, and click it to get a link to that section. This works for Chinese headings too.