一个 h1 标题
段落之间用空行分隔。
第二段。斜体、加粗 和 等宽字体。项目符号列表
看起来像这样:
- 第一项
- 第二项
- 第三项
注意:--- 不考虑星号 --- 实际的文本内容 从第 4 列开始(缩进 4 个空格)。
引用块 可以像这样写。
如果需要, 它们也可以跨越多个段落。
用 3 个短横线表示一个长破折号(em-dash)。用 2 个短横线表示范围(例如:“都在第 12—14 章里”)。三个点 … 会被转换为省略号。 支持 Unicode。☺
一个 h2 标题
下面是一个有序列表:
- 第一项
- 第二项
- 第三项
再次注意实际文本从第 4 列开始(距离左侧 4 个字符)。下面是一个代码示例:
# 让我再重复一遍 ... for i in 1 .. 10 { do-something(i) }如你所猜,缩进了 4 个空格。顺便说一句,除了 缩进这种方式,你也可以使用围栏代码块(delimited blocks),如果你愿意:
define foobar() {print "欢迎来到风味之国!";}(这样更方便复制粘贴)。你还可以为围栏代码块标注语言, 让 Pandoc 做语法高亮:
import time# 快,数到十!for i in range(10): #(但别太快) time.sleep(0.5) print i一个 h3 标题
现在是一个嵌套列表:
-
首先,准备这些食材:
- 胡萝卜
- 芹菜
- 小扁豆
-
烧一锅水。
-
把所有东西倒进锅里,然后按 这个算法执行:
找到木勺掀开锅盖搅拌盖上锅盖把木勺摇摇欲坠地平衡在锅把上等 10 分钟回到第一步(或完成后关火)不要碰到木勺,否则它会掉下去。
再次注意,文本总是按 4 个空格缩进对齐(包括 上面第 3 项最后那一行的续行)。
这里有一个链接指向 一个网站,一个指向 本地文档,还有一个指向 当前文档中的某个小节标题 的链接。这里还有一个脚注 1。
表格示例
表格可以像这样写:
| size | material | color |
|---|---|---|
| 9 | leather | brown |
| 10 | hemp canvas | natural |
| 11 | glass | transparent |
表:鞋子、它们的尺码,以及它们由什么材料制成。
多行表格的替代写法
说明:标准 Markdown 不支持 Pandoc 那种“多行单元格表格”。在 Astro 里最稳妥的做法是:
- 用普通表格把内容压成一行;或
- 用
<br>在单元格内换行(多数 Markdown 渲染器可用)。
| keyword | text |
|---|---|
| red | 日落、苹果,以及 其他红色或偏红的东西。 |
| green | 叶子、草、青蛙, 以及其他东西—— 做绿色可不容易。 |
下面是一条水平分割线。
定义列表的替代写法
说明:标准 Markdown 不原生支持“定义列表”。Astro 默认也未必支持。最通用的写法是用列表来模拟:
- apples:适合用来做苹果酱。
- oranges:柑橘!
- tomatoes:tomatoe 里没有字母 “e”。
“行块”(line block)的替代写法
说明:Pandoc 的 line block 在标准 Markdown 里没有对应语法。最接近的呈现方式是用普通换行(
<br>)或代码块。
第一行
第二行
第三行
第一行第二行第三行图片也可以这样指定:
行内数学公式可以这样写:。行间公式应该单独占一行,并用两个美元符号包起来:
另外注意,你可以用反斜杠转义任何
你希望按字面显示的标点符号,例如:foo、bar 等。
Footnotes
-
脚注内容写在这里。 ↩