Markdown（编辑器）工具与使用总结，以及Markdown语法图文全面详解

原创于 2025-11-25 18:40:54 发布 · 709 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#编辑器 #设计模式

前言

有的时候，对于使用的工具可以做一个总结，以便时时一起，加深记忆理解。在今天做了一份关于 Markdown 工具与使用的比较全面总结，以及其语法的图文详解。无论你是初学者还是有一定经验的用户，这份指南都能为你提供有价值的参考。

一. Markdown 工具与使用总结

1.1 什么是 Markdown？

Markdown 是一种轻量级标记语言，由约翰·格鲁伯于 2004 年创建。它的核心理念是：让人们使用易于阅读、易于编写的纯文本格式进行写作，然后可以转换成结构有效的 XHTML（或 HTML）。

1.1.1 为什么使用 Markdown

专注内容而非样式：无需频繁使用鼠标调整格式，让你专注于写作本身。
纯文本兼容性：意味着可以用任何文本编辑器打开，永不过时。
极高的可移植性：Markdown 文件可以轻松转换为 HTML、PDF、Word、ePub 等多种格式。
强大的平台支持：GitHub、GitLab、Stack Overflow、Reddit 等几乎所有技术平台都原生支持 Markdown。
与版本控制完美契合：因为是纯文本，非常适合用 Git 等进行版本管理，差异对比清晰明了。

1.2 主流 Markdown 编辑器推荐

选择一个合适的编辑器可以极大提升效率。

工具名称	平台	特点与优势	适合人群
Typora	Win/macOS/Linux	所见即所得的开创者，设计极简，写作体验无与伦比。	所有追求沉浸式写作的用户，Markdown 新手和专家的首选。
VS Code	Win/macOS/Linux	功能强大的代码编辑器，通过插件（如 Markdown All in One）成为强大的 Markdown 编辑器。	开发者，需要在写作和编码之间切换的用户。
Obsidian	Win/macOS/Linux	以双向链接为核心的本地知识库管理工具，Markdown 是其基础。	学生、研究员、知识管理者，用于构建个人知识体系。
Notion	Web/Win/macOS/移动端	强大的 All-in-One 工作区，其编辑器核心是 Markdown 风格的快捷方式。	团队协作、项目管理、个人笔记整合需求的用户。
Yu Writer	Win/macOS/Linux	类似 Typora 的所见即所得体验，支持多种文档类型。	喜欢 Typora 但寻求更多主题和功能的用户。
StackEdit	Web	强大的在线编辑器，可实时预览，并直接与 Google Drive、GitHub 等同步。	需要在线编辑和协作的临时用户。

但应该如何去选择呢？

纯写作，追求极致体验：选 Typora。
开发者或已在使用 VS Code：安装 Markdown 插件。
构建个人知识库：选 Obsidian。
团队协作与项目管理：选 Notion。

二. Markdown 语法图文全面详解

下面通过图文并茂的方式，详细讲解最核心和常用的 Markdown 语法。

2.1 标题 (Headers)

使用 # 来表示标题，数量从 1 到 6，对应 HTML 的 <h1> 到 <h6>。

# 这是一级标题 (H1)
## 这是二级标题 (H2)
### 这是三级标题 (H3)
#### 这是四级标题 (H4)
##### 这是五级标题 (H5)
###### 这是六级标题 (H6)

效果：

2.2 段落与换行 (Paragraphs & Line Breaks)

段落：用一个空行来分隔两个段落。
换行：在行尾添加两个空格再回车，或者直接使用一个空行。

这是第一个段落。这一行很长，在编辑器中会自动换行，但在渲染后属于同一个段落。

这是第二个段落。（注意上面有一个空行）

这是第二段的第一行，后面有两个空格  
这是第二段的第二行，因为上一行结尾有两个空格。

效果：

2.3 强调 (Emphasis)

斜体：用 * 或 _ 包裹文本。
粗体：用 ** 或 __ 包裹文本。
粗斜体：用 *** 或 ___ 包裹文本。

这是 *斜体* 这也是 _斜体_。
这是 **粗体** 这也是 __粗体__。
这是 ***粗斜体*** 这也是 ___粗斜体___。

效果：

2.4 列表 (Lists)

2.4.1 无序列表

使用 -、+ 或 * 后跟一个空格。

- 项目一
- 项目二
  - 子项目二点一（缩进两个空格）
  - 子项目二点二
- 项目三

效果：

2.4.2 有序列表

使用数字后跟一个点 . 和空格。

1. 第一项
2. 第二项
   1. 子项一（缩进三个空格）
   2. 子项二
3. 第三项

效果：

2.5 链接与图片 (Links & Images)

链接：[链接文本](链接地址 "可选的标题")
图片：![替代文本](图片URL "可选的标题")

这是一个 [百度](https://www.baidu.com) 的链接。
这是一个带标题的 [Google](https://www.google.com "全球搜索引擎") 链接。

![Markdown标志](https://markdown-here.com/img/icon256.png "这是Markdown")

效果：

2.6 代码 (Code)

行内代码：用 反引号 ` 包裹。
代码块：用 三个反引号 ``` 包裹，并可在开头指定语言以实现语法高亮。

使用 `printf()` 函数来打印内容。

```python
def hello_world():
    # 这是一个Python代码块
    print("Hello, World!")
```

```javascript
// 这是一个JavaScript代码块
function sayHello() {
    console.log("Hello!");
}
```

效果：

2.7 引用 (Blockquotes)

使用 > 符号来表示引用。

> 这是一个单段落的引用。它看起来非常清晰。

> 这是一个多段落的引用。
>
> 这是第二个段落。需要在两个段落之间加一个只有 `>` 的空行。
>
> > 这是嵌套的引用。

效果：

2.8 分割线 (Horizontal Rules)

使用三个或更多的 ***、--- 或 ___ 来创建一条分割线。

上面是内容

***

中间是分割线

---

下面是内容

效果：

2.9 表格 (Tables)

使用连字符 - 来分隔表头和单元格，使用管道符 | 来分隔列。

| 姓名   | 年龄 | 职业       |
| :----- | :--: | :--------- |
| 张三   | 28   | 工程师     |
| 李四   | 32   | 设计师     |
| 王五   | 25   | 产品经理   |

:-- 左对齐
--: 右对齐
:--: 居中对齐

效果：

2.10 任务列表 (Task Lists)

在无序列表项前使用 [ ] 或 [x] 来表示未完成和已完成的任务。

- [x] 完成文章大纲
- [ ] 撰写初稿
- [ ] 校对并发布

效果：

三. 总结与实践建议

元素	语法	备注
标题	`# ## ...`	共六级
粗体	`文本`	优先使用 `**`
斜体	`文本`	优先使用 `*`
代码块	```	指定语言以高亮
链接	`[文本](URL)`
图片	`![替代文本](URL)`
列表	`-` / `1.`	注意缩进
引用	`> 文本`
表格	`\|...\|`	对齐用 `:`
任务列表	`- [ ]`	GFM 扩展