Markdown笔记 | 一篇最详细的Markdown 教程 --> 收好

Markdown 介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。Markdown具有一系列衍生版本，用于扩展Markdown的功能（如表格、脚注、内嵌HTML等等），这些功能原初的Markdown尚不具备，它们能让Markdown转换成更多的格式，例如LaTeX，Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具，如Pandoc；要么基于网站，如GitHub和Wikipedia，在语法上基本兼容，但在一些语法和渲染效果上有改动。 Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。 Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。ÂÂ Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。 Markdown 编写的文档后缀为 .md, .markdown。

Markdown 编辑器

Atom内置对markdown的支持，能够方便的进行解析预览。 打开markdown源文件的步骤如下：

打开Atom编辑器 打开任意的.md文件（markdown源文件） 快捷键Ctrl+Shift+P，打开命令输入页面 输入 markdown preview toggle(可以偷懒只输入mdpt，支持模糊匹配) 就可以实现左边编辑，右边预览了。

Markdown 使用教程

首先，确保已经下载好了 Atom 编辑器，或者你也可以使用上面我介绍的 Markdown 在线编辑器 进行学习练习。 打开 Atom 则打开了一个 Markdown 编辑器，也可以使用新建一个 TXT 文件的方式，然后使用 F2 重命名文件修改后缀为 .md 或 .markdown 。

1. 日常操作

1.1 段落和换行符

段落只是一行或多行连续的文本。在markdown源代码中，段落由两个或多个空行分隔。您只需要一个空行（按Enter一次）即可创建一个新段落。 按Shift+ Enter可创建单个换行符。大多数其他降价解析器将忽略单换行符，因此为了使其他降价解析器识别换行符，您可以在行的末尾留下两个空格，或者插入<br/>。

1.2 头 | 标题

标题#在行的开头使用1-6个hash（）字符，对应于标题级别1-6。例如：

这是一级标题 h1

这是二级标题 h2

这是三级标题 h3

这是四级标题 h4

这是五级标题 h5

这是六级标题 h6

输入'＃'后跟标题内容，Enter按键将创建标题。

1.3 段落（详细）

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。

当然也可以在段落后面使用一个空行来表示重新开始一个段落。

1.4 字体

Markdown 可以使用以下几种字体：

斜体文本 斜体文本

粗体文本 粗体文本

粗斜体文本 粗斜体文本

1.5 分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

1.6 删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线

~~ 即可，实例如下： baidu.com google.com taobao.com

1.7 下划线

下划线可以通过 HTML 的 <u> 标签来实现：</u> <u>带下划线文本</u>

1.8 脚注

脚注是对文本的补充说明。 Markdown 脚注的格式如下: [^要注明的文本] 以下实例演示了脚注的用法： 创建脚注格式类似这样 [^RUNOOB]。

[^RUNOOB]: 【离不开的网】 -- 输出更多好文章！！！

1.10 列表

Markdown 支持有序列表和无序列表。 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记：

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

有序列表使用数字并加上 . 号来表示，如：

1. 第一项
2. 第二项
3. 第三项

1.10.1 列表嵌套

列表嵌套只需在子列表中的选项添加四个空格或Tab即可：

1. 第一项：

• 第一项嵌套的第一个元素
• 第一项嵌套的第二个元素

2. 第二项：
   • 第二项嵌套的第一个元素
   • 第二项嵌套的第一个元素

1.11 区块

Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

Markdown 区块教程 微信公众号【离不开的网】 关注得更多精彩内容

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推：

最外层

第一层嵌套

第二层嵌套

1.11.1 区块中使用列表

区块中使用列表实例如下：

区块中使用列表

1. 第一项> 2. 第二项>> - 第一项> - 第二项> - 第三项

1.11.2 列表中使用区块

如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。

区块中使用列表实例如下：

• 第一项

  【离不开的网】 > 关注得更多精彩内容

• 第二项

  我是一个markdown

1.12 代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（`），例如：

abs()绝对值函数

注：可能很多人打错这个符号 ` ，这个符号是在tab的上面，切换成英文输入点击（tab上方、数字1左边）的键即可。

1.12.1 代码区块

代码区块使用 4 个空格或者一个制表符（Tab 键）。

你也可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定）：

$(document).ready(function () {
  alert('离不开的网');
});

1.13 链接

链接使用方法如下：

链接名称

或者

<链接地址>

如下面这个例子： 这是一个链接 百度链接

直接使用链接地址： <www.baidu.com>

1.13.1 高级链接

链接也可以用变量来代替，文档末尾附带变量地址：

这个链接用 1 作为网址变量 Google

这个链接用 baidu 作为网址变量 [Baidu][baidu]

然后在文档的结尾为变量赋值（网址）

[1]: http://www.google.com/
[baidu]: http://www.baidu.com/

1.14 图片

Markdown 图片语法格式如下：

开头一个感叹号 !

接着一个方括号，里面放上图片的替代文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 'title' 属性的文字。

使用实例： 显示结果如下：

当然，你也可以像网址那样对图片网址使用变量:

这个链接用 1 作为网址变量 baidu. 然后在文档的结尾位变量赋值（网址）

Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用普通的 <img> 标签。

1.15 表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。 语法格式如下：

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

2.2 公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

$$
mathbf{V}_1 times mathbf{V}_2 =  begin{vmatrix}
mathbf{i} & mathbf{j} & mathbf{k}
frac{partial X}{partial u} &  frac{partial Y}{partial u} & 0
frac{partial X}{partial v} &  frac{partial Y}{partial v} & 0
end{vmatrix}
$$tep1}{style{visibility:hidden}{(x+1)(x+1)}}
$$

3. 总结

到这里已经大致把 Markdown 的用法都过了一遍，相信你已经掌握了它的用法，赶快去尝试用 Markdown 做笔记吧！ Markdown —— 作为全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式，说它是极客圈最潮流的文本编辑语言一点也不为过。

• End - | 参考文章 |

   1. https://www.runoob.com/markdown/md-paragraph.html
   2.https://baike.baidu.com/item/markdown/3245829?fr=aladdin
   3.http://support.typora.io/Markdown-Reference/
  

原文地址：https://blog.csdn.net/zonzzz/article/details/123766436?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522168905670416800182729683%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fall.%2522%257D&request_id=168905670416800182729683&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_ecpm_v1~rank_v31_ecpm-18-123766436-null-null.142^v88^control_2,239^v2^insert_chatgpt&utm_term=markdown