使用Markdown语法介绍markdown

---

Markdown简介

---

简介

• Markdown是一种轻量级标记语言，它允许人们使用简单、易读、易写的纯文本格式编写文档。
• Markdown语言在2004年由约翰格鲁伯（英语JohnGruber）创建。
• Markdown编写的文档可以导出为HTML、Word、图像、PDF、Epub等多种格式的文档。
• Markdown编写的文档后缀为 .md 或 .markdown

Markdown的应用

• Markdown被用来撰写电子书，例如Gitbook。
• 当前许多网站都使用Markdown来撰写帮助文档或是用来在论坛\博客上发表文章。例如，Github、简书、Reddit、CSDN等.

编辑器

• Markdown比较有名的编辑器是Typora,包含多种主题，编辑后直接渲染出效果，支持导出多种类型文件。Typora官网
• 很多博客网站也提供Markdown的编辑功能，比如CSDN，本片笔记使用有道云笔记编辑。

测试示例

• Markdown用来写代码笔记非常合适，会针对不同代码进行格式高亮。
• 使用Markdown编写Hello World语法（C语言）

printf("Hello world!");

---

Markdown标题

---

• Markdown的标题有两种格式：

1. 使用=和-分别编辑一二级标题，格式如下：

    我展示的是一级标题
    ==================
    
    这里是二级标题
    ---------------

效果如下

我展示的是一级标题

这里是二级标题

2. 使用#进行标记（使用#号可以表示1–6级标题）

#这里展示的是一级标题（注意标题名称和#号之间要用空格分开，才能正常显示相互格式）
##这里展示的是二级标题
###这里展示的是三级标题

效果如下

这里展示的是一级标题

这里展示的是二级标题

这里展示的是三级标题

---

Markdown段落格式

---

• Markdown没有特殊的段落格式，正常编辑就行，注意一点是段落的换行要使用两个以上的空格加回车也可以在段落后再加一个空行，来表示重新开始一个段落，如下图
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0UQAzB3y-1597551607679)(85FAE2D16AC842C58A508B3FE49A4F7E)]

• 字体
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-XSjm2ujs-1597551607680)(86CFACCEF55748ECBBDEB3617E4431E2)]

---

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

---

• 分割线
• • 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sdKdx9pb-1597551607681)(8F32B99CC4814C57BD807EE7609D0F48)]

显示效果如下

---

---

---

---

---

• 删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线即可，示例如下：
~~ 删除线~~
–删 除 线–

• 下划线
  下划线可以通过HTML的<u>标签实现

  带下划线的文本

• 脚注
  脚注是对文本的补充说明。
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cYTlThix-1597551607683)(A053BFC06CB144D8952B6A76BB5C3DF9)]

Markdown列表

• Markdown支持有序列表和无序列表

• 无序列表使用*号、+号、或是-号作为列表标记，这些标记后面要添加一个空格，然后再填写内容：
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-5zeRN8Ru-1597551607683)(7BE267517BE84AEB97A0D894FF9A9F09)]

  有序列表 使用数字加点来表示，如下图
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ZlK8ySDM-1597551607684)(8F4244D7B633434090CE852F2F8A8FCF)]

• 列表嵌套
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-f1nr6D3H-1597551607685)(9FE092EA6D8A4F3D915B69CCFA5A8856)]

Markdown区块

• Markdown区块引用是在段落开头使用>号，然后后面紧跟一个空格号。
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-NjGKGqT2-1597551607685)(FBD9F1AAC5944AB0A96DA8955ED4FDD3)]

  区块引用
  菜鸟教程
  学的不仅是技术更是梦想

另外区块是可以嵌套的，一个>号是最外层，>>是第一层
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9FWAAiHv-1597551607686)(913527E197C441E49CEDD69E2365E9BC)]

最外层

第一层

第二层

• 区块中使用列表
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-e5VqPlaK-1597551607686)(E0CC00068E4840698AA73F9FED85215D)]

区块中使用列表
1.第一项
2.第二项

• 第三项

• 列表中使用区块
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ybAOLwXW-1597551607686)(9240F76EAF404591A4B0CDDCD4700F60)]

• 第一项

  菜鸟教程
  哈哈哈

• 第二项

Markdown代码

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

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

  代码段：
  main()
  {
  printf(“hello world!\n”);
  }

• 也可以使用```包裹一段代码，并指定一种语言（也可以不指定）。显示如下

    int main()
    {
        printf("hello world!\n");
        return 0;
    }

Markdown链接

• 链接使用方法如下
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9e2BPfdA-1597551607687)(74862802267D432B95CE7196CF7C6F37)]
  这是"菜鸟教程"链接
  直接使用链接地址：https://www.runoob.com/markdown/md-tutorial.html

• 高级链接
  我们可以通过变量来设置一个链接，变量赋值在文档末尾进行：
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-DYqODUXe-1597551607687)(D0CFEB6CCC6F4CCD8B591F5B7CB48ACA)]

显示结果如下：
这个链接用 1 作为网址变量 [Google] 1
这个链接用test作为网址变量 baidu
在文档结尾为变量赋值

Markdown图片

Markdown图片语法格式如下：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-oGRScvJh-1597551607688)(972A94FE5355448385219EB30AAA361E)]

• 图片如下
  
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gWyiBekS-1597551607689)(http://static.runoob.com/images/runoob-logo.png “RUNOOB”)]

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

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

Markdown表格

• Markdown制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。
  语法格式如下：
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xmJyEP2A-1597551607689)(48E7EE156C4D43F680CB2634370AA948)]
• 已上代码显示如下：

表头	表头
单元格	单元格
单元格	单元格

• 对齐方式：
  我们可以设置对齐方式如下：

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

Markdown高级技巧

• 支持HTML元素

• • 不在Markdown覆盖范围之内的标签，都可以直接在文档里用HTML撰写。
• • 目前支持的HTML元素有:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sagy6SOo-1597551607689)(31901A2029F546CCBCD9AAC7B74D1824)]

• 转义字符
  Markdown使用了很多特殊字符来表示特定的意义，如果需要显示特定的符号，则需要使用转义字符，Markdown使用反斜杠转义特殊字符：
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kfZdaPuc-1597551607690)(4046783B1F784DDCA4CDC374A4309C11)]
  Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-IlqSuLF4-1597551607690)(7428FFAAFC57432EBA701EFBC90EB5D9)]

公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符号$$包裹Tex或LaTex格式的数学公式来实现，提交后问答和文章会根据需要加载Mathjax对数学公式进行渲染。例如：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Lhm5oBgG-1597551607690)(92D0B029E5434A3BB30E1D65B818C2CA)]
输出结果如下

$${\mathbf{V}}_1\times {\mathbf{V}}_2=\left|\begin{array}{ccc}\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{array}\right|$$

---

---

已上是Markdown的所有操作（有些遗漏后续会完善）

第一次使用Markdown写笔记许多问题后续改进。—2020-8-16