Markdown 写作指南

Fluid for Astro 使用 Astro 内置的 Markdown 渲染器，默认支持 GitHub Flavored Markdown（GFM），并额外接入了公式与 Mermaid。下面是一份可以直接对照使用的语法速查表。

#标题与目录

文章中的 ## 到 ###### 会自动生成锚点，并出现在右侧目录中。点击标题左侧的 # 可以复制当前章节的链接。

#三级标题

#四级标题

目录会根据标题层级自动嵌套，折叠状态由 postConfig.toc 控制。

#文本

普通文本、加粗、斜体、删除线、行内代码、链接 都可以直接使用。

这是一段引用。

引用可以包含多个段落，也可以嵌套其他 Markdown 元素，例如 加粗 与 链接。

#列表

无序列表：

• 苹果
• 香蕉
  • 皇帝蕉
  • 香蕉牛奶
• 橙子

有序列表：

1. 安装依赖
2. 修改配置
3. 运行构建

任务列表：

• 完成主题移植
• 编写文档
• 添加更多示例

#表格

功能	配置项	默认值
文章目录	postConfig.toc.enable	true
图片灯箱	postConfig.imageZoom.enable	true
代码复制	codeConfig.copyBtn	true
本地搜索	searchConfig.enable	true
每页文章数	indexConfig.pageSize	5

#代码块

带语言标注的代码块会自动高亮，并显示语言标签与复制按钮：

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

export function sortPosts(posts: Post[]): Post[] {
	return [...posts].sort((a, b) => b.date.getTime() - a.date.getTime());
}

没有语言标注时，会显示配置中的默认语言（默认 TEXT）：

这是一段没有语言标注的文本。
它仍然会被 Shiki 转义并保持等宽显示。

#数学公式

行内公式：当 $a \ne 0$ 时，方程 $ax^2 + bx + c = 0$ 有两个解。

独立公式：

$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

矩阵与求和：

$$\begin{pmatrix} a & b \\ c & d \end{pmatrix} \quad \sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$

公式由 KaTeX 在构建时渲染，不需要在浏览器中加载 MathJax。

#Mermaid 图表

```mermaid
flowchart LR
  A[Markdown] --> B[remark]
  B --> C[rehype]
  C --> D[HTML]
  D --> E[Astro]
```

实际渲染效果：

flowchart LR
  A[Markdown] --> B[remark]
  B --> C[rehype]
  C --> D[HTML]
  D --> E[Astro]

#图片与图注

图片会自动懒加载、添加图注，并支持点击放大：

图注来自图片的 title 或 alt 属性。如果想关闭图注，把 postConfig.imageCaption.enable 设为 false。

#脚注

Astro 支持 GFM 脚注语法。这里有一个脚注引用¹，还有另一个²。

#分隔线

---

#小结

以上语法覆盖了日常写作的绝大多数场景。如果需要更复杂的排版，也可以直接在 Markdown 中写 HTML，Astro 会原样保留。

#Footnotes

1. 脚注内容会自动收集到文章末尾。 ↩

2. 脚注同样支持 Markdown 语法与 链接。 ↩