906 字
5 分钟
Markdown 示例

一个 h1 标题#

段落之间用空行分隔。

第二段。斜体加粗等宽字体。项目符号列表 看起来像这样:

  • 第一项
  • 第二项
  • 第三项

注意:--- 不考虑星号 --- 实际的文本内容 从第 4 列开始(缩进 4 个空格)。

引用块 可以像这样写。

如果需要, 它们也可以跨越多个段落。

用 3 个短横线表示一个长破折号(em-dash)。用 2 个短横线表示范围(例如:“都在第 12—14 章里”)。三个点 … 会被转换为省略号。 支持 Unicode。☺

一个 h2 标题#

下面是一个有序列表:

  1. 第一项
  2. 第二项
  3. 第三项

再次注意实际文本从第 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 标题#

现在是一个嵌套列表:

  1. 首先,准备这些食材:

    • 胡萝卜
    • 芹菜
    • 小扁豆
  2. 烧一锅水。

  3. 把所有东西倒进锅里,然后按 这个算法执行:

    找到木勺
    掀开锅盖
    搅拌
    盖上锅盖
    把木勺摇摇欲坠地平衡在锅把上
    等 10 分钟
    回到第一步(或完成后关火)

    不要碰到木勺,否则它会掉下去。

再次注意,文本总是按 4 个空格缩进对齐(包括 上面第 3 项最后那一行的续行)。

这里有一个链接指向 一个网站,一个指向 本地文档,还有一个指向 当前文档中的某个小节标题 的链接。这里还有一个脚注 1

表格示例#

表格可以像这样写:

sizematerialcolor
9leatherbrown
10hemp canvasnatural
11glasstransparent

表:鞋子、它们的尺码,以及它们由什么材料制成。


多行表格的替代写法#

说明:标准 Markdown 不支持 Pandoc 那种“多行单元格表格”。在 Astro 里最稳妥的做法是:

  1. 用普通表格把内容压成一行;或
  2. <br> 在单元格内换行(多数 Markdown 渲染器可用)。
keywordtext
red日落、苹果,以及
其他红色或偏红的东西。
green叶子、草、青蛙,
以及其他东西——
做绿色可不容易。

下面是一条水平分割线。


定义列表的替代写法#

说明:标准 Markdown 不原生支持“定义列表”。Astro 默认也未必支持。最通用的写法是用列表来模拟:

  • apples:适合用来做苹果酱。
  • oranges:柑橘!
  • tomatoes:tomatoe 里没有字母 “e”。

“行块”(line block)的替代写法#

说明:Pandoc 的 line block 在标准 Markdown 里没有对应语法。最接近的呈现方式是用普通换行(<br>)或代码块。

第一行
第二行
第三行

第一行
第二行
第三行

图片也可以这样指定:

行内数学公式可以这样写:ω=dϕ/dt\omega = d\phi / dt。行间公式应该单独占一行,并用两个美元符号包起来:

I=ρR2dVI = \int \rho R^{2} dV

π=3.1415926535;8979323846;2643383279;5028841971;6939937510;5820974944;5923078164;0628620899;8628034825;3421170679;\begin{equation*} \pi =3.1415926535 ;8979323846;2643383279;5028841971;6939937510;5820974944 ;5923078164;0628620899;8628034825;3421170679;\ldots \end{equation*}

另外注意,你可以用反斜杠转义任何 你希望按字面显示的标点符号,例如:foobar 等。

Footnotes#

  1. 脚注内容写在这里。

Markdown 示例
https://blog.goatpretty.com/posts/markdown/
作者
GoatPretty
发布于
2023-10-01
许可协议
CC BY-NC-SA 4.0