当前位置：首页 > news >正文

Markdown学习，从入门到吃土

news 2026/5/12 13:54:23

Markdown学习，从入门到吃土

前言：为什么选择 Markdown？

以前大家都喜欢使用word来进行文档编辑，然而在新时代，word的一些特性导致其在一些情景并没有那么好用。
作为富文本范式的WORD，编辑起来固然较为方便，然而，正是他的便捷性和可视化，导致他在迁移或编辑时有较大的局限性，尤其对于LLM来说，如果直接将word文件上传给LLM，会存在两个较大的问题，一是由于富文本隐藏的样式定义会使用户消耗比文本量多许多的token，二是读取过程可能导致格式错乱，进而出现逻辑错误，而作为一种轻量级标记语言的Markdown，其作为一种纯文本类型的语言，很好的解决了word的弊端，同时使用熟练后，效率可能比使用word还高。

当然，随着进一步人工智能的进一步发展，或许能够让LLM对于word的解析能力得到提高，但是在一段时间内，markdown依然是人们的一个良好的选择，这篇文章就让我来介绍一下markdown语言的基本用法

一、基础语法

1. 标题（Headings）

使用 # 符号表示标题，数量代表层级（1-6级）：

# 一级标题（H1）
## 二级标题（H2）
### 三级标题（H3）
#### 四级标题（H4）
##### 五级标题（H5）
###### 六级标题（H6）

渲染效果：

一级标题

二级标题

三级标题

注意：一级标题通常用于文章标题，文档内建议从二级标题开始使用，保持层级清晰，同时，如果你想写标题，那么最后一个#后面需要加空格如示例展示的一样，否则不会被识别为标题。

2. 段落与换行

段落：空行分隔即可

这是第一段。这是第二段，与上文有空行分隔。

换行：行尾添加两个空格 + 回车

这是第一行··
这是第二行（··代表两个空格）

3. 强调样式

样式	语法	示例	效果
粗体	`文字` 或 `__文字__`	`重要`	重要
斜体	`文字` 或 `_文字_`	`强调`	强调
删除线	`~~文字~~`	`~~过时~~`	过时
粗斜体	`*文字*`	`*关键*`	关键

注意：中文与强调符号间建议加空格，如 ** 重要 **，避免某些解析器识别失败。

4. 列表

无序列表

使用 -、+ 或 * 作为标记（建议统一使用 -）：

- 苹果
- 香蕉- 进口香蕉（缩进2空格）- 国产香蕉
- 橙子

效果：

苹果
香蕉
- 进口香蕉
- 国产香蕉
橙子

有序列表

使用数字加句点：

1. 第一步：准备工作
2. 第二步：执行操作1. 子步骤 A（缩进3空格）2. 子步骤 B
3. 第三步：检查结果

效果：

第一步：准备工作
第二步：执行操作
1. 子步骤 A
2. 子步骤 B
第三步：检查结果

技巧：数字不必连续，渲染时会自动排序（都写 1. 也可以）。

5. 链接与图片

链接

[链接文字](URL "可选标题")

示例：

访问 [Markdown 指南](https://markdown.com.cn "官方文档")

效果：访问 Markdown 指南

图片

![替代文字](图片URL "可选标题")

示例：

![这是谁](https://img-s.msn.cn/tenant/amp/entityid/AA1G74Dq.img)

效果：

这是谁

引用式链接（适合长文档）

[链接文字][id]文末定义：
[id]: URL "标题"

6. 引用块

使用 > 符号：

> 这是一段引用文字。
> 可以跨越多行。
>
> > 嵌套引用（多加一个 >）

效果：

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

嵌套引用

7. 代码

行内代码

使用反引号 ` 包裹：

使用 `printf()` 函数输出

效果：使用 printf() 函数输出

代码块

使用三个反引号 ``` 包裹，并指定语言以获得语法高亮：

```python
def hello():print("Hello, Markdown!")
```

效果：

def hello():print("Hello, Markdown!")

8. 分隔线

三种写法均可：

---
***
___

效果均为一条水平分隔线：

9. 表格

使用 | 和 - 构建：

| 姓名 | 年龄 | 城市 |
| :--- | :---: | ---: |  <!-- 左对齐 | 居中 | 右对齐 -->
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |

效果：

姓名	年龄	城市
1张三	25	北京1
11李四	30	上海11

注意： 中间不添加内容只有-的放在表头下方，每一列的-的数量要在3个以上，同时可以通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心。如示例中所示

二、进阶技巧

1. 任务列表（GFM 扩展）

- [x] 已完成任务
- [ ] 未完成任务- [x] 子任务 A- [ ] 子任务 B

效果：

已完成任务
未完成任务
- 子任务 A
- 子任务 B

2. 脚注

这是一个需要脚注的句子[^1]。[^1]: 这是脚注内容，会显示在文档底部。

3. 数学公式（LaTeX）

行内公式： $E=mc^2$

渲染效果：$E=mc^2$

块级公式：

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

渲染效果：

\[\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n \]

4. 折叠内容（HTML5 标签）

<details>
<summary>点击展开详情</summary>这里是隐藏的内容，支持 Markdown 语法。- 列表项 1
- 列表项 2
</details>

5. 与 HTML 混用

当 Markdown 无法满足需求时，可直接使用 HTML：

<div align="center"><img src="https://ts3.tc.mm.bing.net/th/id/OIP-C.F3WG1F4go_JJ84hZ7xdvHAHaEK" width="200"><p><b>这是谁</b></p>
</div><span style="color:red">红色文字</span>

效果：

这是谁

红色文字

三、实用工具推荐

工具类型	推荐工具	特点
编辑器	Typora	所见即所得，实时预览
编辑器	VS Code	插件丰富，适合技术写作
在线工具	墨滴编辑器	无需安装，即开即用
转换工具	Pandoc	支持 PDF/Word/EPUB 导出
图床	GitHub + jsDelivr	免费稳定，适合博客