Markdown 教程（一小时学会）

Markdown 是什么？

Markdown 是一种轻量级的标记语言，由 John Gruber 和 Aaron Swartz 于 2004 年创建。Markdown 可以让你使用一种 “易读易写的纯文本格式” 来编写文档，然后轻松地转换为一个网页（HTML 格式）。

Markdown 的语法十分简单、可读性强。相比于复杂的排版软件，Markdown 只需要很少的符号，就可以轻松地将文本转换为格式丰富的文档。

Markdown 相对于传统的富文本编辑器（例如 Microsoft Word）来说，具有很多优点。

• 轻量化：Markdown 文件是纯文本文件，易于读写，文件体积也很小。
• 易于学习：Markdown 的语法非常简单，学习曲线平缓，短时间内即可掌握。
• 可移植性好：Markdown 文件可以在任何支持纯文本格式的设备中打开和编辑。
• 转换方便：Markdown 文件可以轻松地转换为 HTML、PDF 等多种格式。

Markdown 语法

Markdown 是一种标记语言，它使用的特殊符号（也称为 “标记符”），来表示不同的文本格式。

语法：

标记符 内容

说明：

一般情况下（特别是针对标题、列表等段落格式），“标记符” 与 “内容” 之间需要有一个空格。Markdown 的语法非常简单，它只使用一些简单的符号来表示不同的格式，比如 #、*、> 等。

举个例子，我们可以用 “# 绿叶网” 来将定义一个标题。当 Markdown 解释器遇到 “#” 标记符时，就会将它后面的内容以 “标题” 的样式显示出来（如下图所示）。其中 “# 绿叶网” 最终会转换为下面的 HTML 代码。

<h1>绿叶网</h1>

Markdown 是一门描述性的语言，就是用标记符来说话的。举个例子，如果你想要显示一个标题，就应该使用 “#” 符号。如果想要显示无序列表，就应该使用 “-” 符号。针对你想显示东西的不同，使用的标记符也会不同。

总而言之，学习 Markdown 就是学习各种各样的标记符，然后针对你想显示什么东西，再对应地使用正确的标记符，非常简单。

Markdown 应用场景

由于 Markdown 具有诸多优点，因此它被广泛地应用于各种场景中，包括：

• 撰写文档和笔记：这是 Markdown 最基础也是最广泛的应用。无论是个人笔记、会议记录、项目文档还是技术文档，Markdown 都因其简洁易读的特性成为首选。
• 在线博客写作：许多博客平台和内容管理系统都支持 Markdown，使得创作者可以专注于内容创作，而不需要过多关注复杂的排版。
• 代码托管平台（如 Gitee、GitHub、GitLab、Bitbucket 等）：这些平台广泛使用 Markdown 来渲染 README 文件、项目 Wiki、Issue 和 Pull Request 的评论等，方便开发者阅读和交流。
• 即时通讯工具（如 Slack、Discord）：许多现代即时通讯工具支持 Markdown 语法，用于发送格式化的消息，提高沟通效率和可读性。
• 静态网站生成器：许多流行的静态网站生成器都以 Markdown 作为主要的内容格式，方便快速构建和维护网站。

可能有小伙伴会问：“我直接使用 Word 来编辑文档不行吗？为什么要使用 Markdown 来编辑呢？”实际上，Word 编辑得到的文档只限于在类似 Word 这样的软件去查看。如果你希望编辑的文档能直接在浏览器中查看，也就是希望将编辑的文本转换成 “一个网页”，此时使用 Markdown 是最简单的方式。

Markdown 示例

下面我们来看一个简单的例子，让小伙伴们感性认识 Markdown 是怎样的一个东西。

示例：

# 欢迎来到绿叶网

* Python
* C++
* Java

> 不要以战术上的勤奋，去掩盖战略上的懒惰。

渲染效果如下图所示。

分析：

对于上面 Markdown 代码来说，它会最终转换为下面的 HTML 代码。

<h1>欢迎来到绿叶网</h1>
<ul>
    <li>Python</li>
    <li>C++</li>
    <li>Java</li>
</ul>
<blockquote>
    <p>不要以战术上的勤奋，去掩盖战略上的懒惰。</p>
</blockquote>

如果小伙伴们想要对 Markdown 理解得更加深入，建议先学一下 HTML。当然了，咱们绿叶网也有相关的教程：HTML 教程。