文章

Markdown 基础语法:从标题到代码块

·

用 Typst 排版演示 Markdown 的标题、强调、列表、链接、引用、代码与表格等基础语法。

1. 引言

Markdown 是一种轻量级标记语言,用少量符号即可表达文档结构。本文用 Typst 排版,逐项演示 Markdown 的基础语法:标题、强调、列表、链接、引用、代码与表格。

1.1. 标题

Markdown 用行首的 # 数量表示标题层级,一个 # 是一级标题,两个 # 是二级标题,依此类推。

1.2. 强调

用一对星号包裹文字表示 斜体,用两对星号表示 粗体,也可以组合使用。

1.3. 列表

无序列表用行首的短横线表示:

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

有序列表用数字加点表示:

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

1.4. 链接

行内链接写作方括号加圆括号,例如 Typst 官网。

1.5. 引用

在行首加一个大于号即可引用他人的话:

好的排版让读者忘记排版本身的存在。

1.6. 代码

行内代码用一对反引号包裹,例如 print("hello")。多行代码块用三个反引号围起,并可标注语言:

def greet(name):
    return f"Hello, {name}!"

1.7. 表格

Markdown 用竖线分隔单元格,第二行用短横线分隔表头与表体:

语法写法效果
标题# 标题一级标题
强调*文字*斜体
代码 代码 等宽字体

1.8. 小结

以上语法覆盖了日常写作的绝大多数场景。掌握它们之后,就可以用纯文本写出结构清晰、便于版本管理的文档。