Markdown 排版速查手册

本文是主题排版的「样张」：几乎所有元素都能在这一页里找到效果。

标题层级

正文标题从 h2 开始使用，目录（TOC）会自动收集到侧栏：

三级标题

这里是三级标题下的段落。中文正文使用 行高 2 与两端对齐，是中文博客最舒适的阅读设置。

四级标题

更深的层级建议少用，长文拆分成多篇文章往往更好。

文字样式

加粗、斜体、删除线、行内代码、外部链接，以及组合的 粗斜体 效果。

按键写作如 Ctrl + K 可以快速呼出本站的搜索弹窗。

代码块

代码块使用 Shiki 双主题高亮，自动适配明暗模式，右上角悬停出现复制按钮：

interface Post {
  title: string;
  date: Date;
  tags: string[];
}

export function formatPost(post: Post): string {
  return `${post.date.getFullYear()} · ${post.title}`;
}

def fibonacci(n: int) -> list[int]:
    """斐波那契数列"""
    seq = [0, 1]
    while len(seq) < n:
        seq.append(seq[-1] + seq[-2])
    return seq[:n]

# 构建并预览生产版本
npm run build && npm run preview

引用与提示块

引用块自带左侧竖线与灰色文字，适合放补充说明或引用他人观点。 多行内容可以一直延续。

六色 Note 提示块：

彩色标签：

Default Primary Info Success Warning Danger

列表

无序列表：

• 四套布局方案随意切换
• 暗色模式自动跟随系统
  • 支持手动切换并记忆选择
  • 刷新页面不闪烁
• 移动端完整适配

有序列表：

1. 安装依赖
2. 修改 src/config.ts
3. 在 src/content/posts/ 写作
4. npm run build 发布

表格

功能	NexT	本主题
四套 scheme	✅	✅
暗色模式	✅	✅
本地搜索	✅	✅
View Transitions	❌	✅
默认零客户端 JS	❌	✅

图片与分割线

---

以上就是全部常用元素。写作时把这一页当样板间对照即可。