文章
Markdown 基础语法:从标题到代码块
·
用 Typst 排版演示 Markdown 的标题、强调、列表、链接、引用、代码与表格等基础语法。
1. 引言
Markdown 是一种轻量级标记语言,用少量符号即可表达文档结构。本文用 Typst 排版,逐项演示 Markdown 的基础语法:标题、强调、列表、链接、引用、代码与表格。
1.1. 标题
Markdown 用行首的 # 数量表示标题层级,一个 # 是一级标题,两个 # 是二级标题,依此类推。
1.2. 强调
用一对星号包裹文字表示 斜体,用两对星号表示 粗体,也可以组合使用。
1.3. 列表
无序列表用行首的短横线表示:
- 第一项
- 第二项
- 第三项
有序列表用数字加点表示:
- 第一步
- 第二步
- 第三步
1.4. 链接
行内链接写作方括号加圆括号,例如 Typst 官网。
1.5. 引用
在行首加一个大于号即可引用他人的话:
好的排版让读者忘记排版本身的存在。
1.6. 代码
行内代码用一对反引号包裹,例如 print("hello")。多行代码块用三个反引号围起,并可标注语言:
def greet(name):
return f"Hello, {name}!"1.7. 表格
Markdown 用竖线分隔单元格,第二行用短横线分隔表头与表体:
| 语法 | 写法 | 效果 |
| 标题 | # 标题 | 一级标题 |
| 强调 | *文字* | 斜体 |
| 代码 | 代码 | 等宽字体 |
1.8. 小结
以上语法覆盖了日常写作的绝大多数场景。掌握它们之后,就可以用纯文本写出结构清晰、便于版本管理的文档。