从小白到高手：彻底掌握 Markdown 的终极指南！

前言

Markdown 是一种简洁高效的文本标记语言，因其简单的语法和广泛的兼容性而广受欢迎。在 Markdown 中，通过少量的符号即可实现文本的结构化表达，如标题、列表、表格、链接和图片等。它的核心特点是直观易读，无需额外工具即可理解原始文本，同时支持快速转换为 HTML 等格式，适用于文档编写、博客发布和技术记录等场景。

Markdown介绍

1. Markdown 是一种轻量级标记语言，通常用于简单文本格式和内容排版；
2. 通过使用易读易写的纯文本格式， 可以快速的转换为HTML 等格式，用于撰写博客，论坛帖子，文档等，包括本片介绍也是使用Markdown语法撰写。

Markdown的优点

很多人看到语言就会联想到c语言、c++语言， 然后就想着为了写个文档总不能单独去学一门语言吧， 从而直接放弃。实则不然， Markdown 是一门非常简单的语言，甚至简单于word编写。 Markdown的优点包括：

1. 简单易学： Markdown的语法简单直观， 易于学习和使用；
2. 纯文本：可在任何文本编辑器总编写， 跨平台兼容性强；
3. 快速： Markdown能快速的将内容转换为格式良好的文档；
4. 易读：Markdown文档即使未经渲染也很易读，对于版本控制系统如Git也友好；
5. 广泛支持：许多平台和工具支持Markdown， 如github、掘金；
6. 丰富性：Markdown语法支持丰富的文本格式，如标题、列表、链接、图片等；
7. 可扩展性：Markdown可以通过扩展语法实现更复杂的功能，如表格、脚注等；
8. 输出格式多样性：Markdown可以轻松转换为多种格式， 如HTML、PDF等。

Markdown 语法介绍

标题

使用# 标记不同级别的标题，随着#递增表示一级标题到六级标题，例如：#表示一级标题，##表示二级标题，以此类推。其中一级标题最大，六级标题最小。

注意：

1. 最后一个#字符与标题中间留一个空格；
2. 标题应该在行首， 放在表格中会无法解析。

段落

段落支持Markdown和HTML两种语法，详细如下：

1. Markdown语法：使用空白行将多行文本进行分隔；
2. HTML语法：使用<p></p>标签分隔文本。

换行

Markdown文档换行有很多方式，同样支持Markdown语法和HTML语法，详细如下：

1. 在一行的末尾添加两个或者多个空格；
2. 采用HTML中</br>标签换行；
3. 在行尾添加反斜杠\进行换行。

字体

字体主要分为粗体和斜体，在文档中一般通过字体来强调起重要性。字体也支持Markdown和HTML两种语法。

1. 斜体： Markdown语法：通过*或者_ 进行设置； HTML语法：通过<em></em>进行设置。
2. 粗体： Markdown语法：通过**或__进行设置； HTML语法：通过<strong></strong>进行设置。
3. 粗斜体： Markdown语法：通过***、___ 或者__*文字*__、**_文字_**进行设置； HTML语法：通过<strong><em></em></strong>进行设置。

注意：

1. 虽然字体设置方法有多种， 但Markdown 应用程序在处理单词或短语中间添加的下划线上并不一致， 所以为了兼容其他，请使用*去设置;
2. 标识符与文字之间不需要留空格。

引用

创建引用，请在段落前加一个>。

列表

列表分为有序列表和无需列表，支持Markdown语法和HTML语法。

1. 有序列表： Markdown语法：数据紧跟英文句点，数字无需按顺序排列，但是列表应当以数字1起始，缩进一个或者多个列表项可创建嵌套列表。 HTML语法：<ol><li><li></ol>
2. 无须列表： Markdown:每个列表项前面添加破折号-、星号*或加号+，缩进一个或者多个列表项可创建嵌套列表。 HTML语法：<ul><li></li></ul>

注意事项： 为了保证兼容性，当创建有序/无序列表时尽量使用Markdown语法。

代码块

Markdown中代码有两种：

1. 一行内引用代码：直接将也需要引用的部分包裹在反引号 (`) 中。如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。
2. 代码块 如果需要将内容或者代码添加到一个代码块中，可以通过创建代码块来实现， 方法有两种。
   • 在需要引用内容的前一行和后一行使用三个反引号， 如果想在代码块中引入代码，则需要在前一个反引号后面西写入需要的语言， 例如js。
   • 将引用内容的每一行缩进至少四个空格或一个制表符。

分割线

Markdown给出了多种分割线方法， 使用分割线可以是内容结构更加清晰。分割线的使用，可以在单独一行上使用三个或三个或多个星号（***）、破折号（---）或下划线（___），并且不能包含其他内容。

链接

Markdown文档中添加链接， 可以直接使用户点击到对应的网址，体验更佳。 添加链接的方式有两种：

1. 超链接Markdown语法代码：[超链接显示名](超链接地址"超链接title"),其中title可选。例如：[Markdown](https://markdown.com.cn/ 'markdown标题')
2. 使用尖括号把url变成可访问的链接：例如，<https://markdown.com.cn/>

图片

Markdown文档中直接添加图片也是常用的方法，这样会省去很多不必要的写入。语法如下：

1. 添加展示图片：![alt 属性文本](图片链接 "图片title")[图片title可选];
2. 添加链接图片：将图像的Markdown 括在方括号中，然后将链接添加在圆括号中， 列如： [![图片](/assets/img/shiprock.jpg "Shiprock")](https://markdown.com.cn)

删除线

Markdown文档中添加删除线， 可以使用~~进行设置,语法如下：~~删除线~~

下划线

Markdown文档中添加下划线， 可以使用<u></u>进行设置，语法如下：<u>下划线</u>

转义字符

Markdown文档中使用特殊字符， 可以使用\进行转义， 语法如下：\* 具体转义字符包含哪些，详情可查看官方文档 Markdown转义字符列表。

注意： 因为在md文档中， 一般都会支持HTML的写法， 所以对一些特殊的字符是会自动去转义， 比如< 会转成<, &会转成&。

表格

Markdown中也支持表格，语法如下：

1. 表格使用|来分割不同单元格，使用-来分割表头和其他行;
2. :-:：将表头于单元格内容居中对齐；
3. -:：将表头与单元格内容左对齐；
4. :-：将表头与单元格内容右对齐。

任务列表

Markdown中也支持任务列表，语法如下：

1. 未完成的任务：- [ ] 任务名称;
2. 已完成的任务：- [x] 任务名称。

总结

Markdown 是轻量、高效、跨平台的文本工具，不仅降低了格式化文本的门槛，也极大提升了文档编辑与协作的效率，是现代文本处理的重要工具之一。