Skip to content

2. 进阶格式与语法

"掌握进阶语法,让文档更丰富、更专业。"

在基础语法之上,Markdown 提供了更多格式化选项,包括行内代码、代码块、引用、水平线等,这些能帮助你更好地组织和呈现内容。

2.1 行内代码

使用反引号 ` 包裹代码或命令:

markdown
使用 `git commit` 命令提交更改。

渲染:使用 git commit 命令提交更改。

多行代码:使用三个反引号 ``` 创建代码块(详见 3.2 节)。

2.2 引用

使用 > 创建引用块:

markdown
> 这是一段引用文字。
> 可以有多行。
>
> 引用可以包含空行。

渲染:

这是一段引用文字。 可以有多行。

引用可以包含空行。

嵌套引用

引用可以嵌套:

markdown
> 一级引用
> > 二级引用
> > > 三级引用

引用中的其他元素

引用块内可以包含其他 Markdown 元素:

markdown
> **注意**:这是一个包含粗体和代码的引用:
> - 使用 `npm install` 安装依赖
> - 运行 `npm run dev` 启动开发服务器

2.3 水平线

使用三个或更多的 -*_ 创建水平分割线:

markdown
---
***
___

渲染效果:


用途

  • 分隔文档的不同部分
  • 在内容之间创建视觉分隔
  • 替代分页符

2.4 转义字符详解

Markdown 解析器会将某些字符解释为格式标记。要在文档中显示这些字符本身,需要使用反斜杠转义:

字符转义说明
\\\反斜杠
`\`反引号
*\*星号(粗体/斜体)
_\_下划线(粗体/斜体)
{ }\{ \}花括号(某些扩展)
[ ]\[ \]方括号(链接)
( )\( \)圆括号(链接)
#\#井号(标题)
+\+加号(列表)
-\-减号(列表/水平线)
.\.点号(有序列表)
!\!感叹号(图片)
``|

示例:

markdown
C:\Windows\System32
\* 重要提示 \*

渲染:

  • C:\Windows\System32
  • * 重要提示 *

2.5 任务列表

GitHub Flavored Markdown 支持任务列表(checkbox):

markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

渲染:

  • [x] 已完成任务
  • [ ] 未完成任务
  • [ ] 待办事项

用途

  • 项目待办事项
  • 功能清单
  • 步骤跟踪

2.6 脚注

脚注允许在文档中添加参考注释:

markdown
这里有一段文字需要注释[^1]。

[^1]: 这是脚注内容,可以包含链接 [Google](https://google.com)。

渲染: 这里有一段文字需要注释[^1]。

[^1]: 这是脚注内容,可以包含链接 Google

注意:脚注标记可以是数字或文字,如 [^note]

2.7 自动链接

对于纯 URL 或邮箱地址,使用尖括号自动创建链接:

markdown
访问 https://example.com 了解更多。
联系 support@example.com 获取帮助。

<https://example.com>
<support@example.com>

渲染:


练习

  1. 创建一个包含引用块和水平线的文档
  2. 编写一个任务列表,标记已完成和未完成的项目
  3. 使用转义字符显示特殊符号(如 C:\Windows*重要*
  4. 添加脚注到文档中

上一篇: 1. Markdown 基础语法
下一篇: 3. 表格、代码与数学公式