简介
Markdown是一门轻量级标记语言，它使用简洁的语法代替排版，使我们专心于码字．
它使用简洁的字符标记来达到office/Word中的各种字体/段落等手动设置．由于每个人在使用Word时的文本设置各不相同，就算同一个人，在不同的文档中可能使用的设置方式都不同，就造成了文本的格式和外观千奇百怪．这不利于传播和阅读．
使用Markdown语法来创造内容如记录笔记，写网络博客等各种文档则要方便的多，除了最开始入门时需要记住常规的Markdown标记语法之外，使用Markdown语法写出的文档外观十分优雅简洁，看起来令人赏心悦目．再也不用在Word中每次都手动设置各种字体段落格式了，以后自己记录的所有文档都只有一种格式。这点对于经常在win10和linux系统来回切换的同学十分重要。
Markdown常用语法
标题/Header
在标题前面加上１－６个#，表示一级标题，二级标题...六级标题（＃和标题内容之间至少一个空格符隔开）：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
输出效果：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表/Lists
Markdown支持有序列表和无序列表．
无序列表使用*或者-或者+作为列表标记：
* Red
* Green
* Blue
- Red
- Green
- Blue
+ Red
+ Green
+ Blue
输出效果：
- Red
- Green
- Blue
有序列表使用数字＋英文句点来表示：
markdown
1. Red
2. Green
3. Blue
输出效果：
- Red
- Green
- Blue
强调/Emphasis
两个*或者-表示加粗，一个*或者-表示斜体，~~表示删除：
**加粗文本**或者__加粗文本__
*斜体文本*或者_斜体文本_
~~删除文本~~
输出效果：
加粗文本或者加粗文本
斜体文本或者斜体文本
删除文本
链接/Links
链接语法可掌握常见的２种：标准式和自动链接：
标准式链接： [百度主页](https://www.baidu.com)
自动链接：直接用`<>`括起来<https://www.google.com>
输出效果：
标准式链接： 百度主页
自动链接：直接用<>括起来https://www.google.com
图片/Images
图片和链接的语法很像，区别在于图片比链接多了一个!．基本格式：
图片： ![]() 
实际插入图片时，常用的有两种情况：插入本地图片和插入网页图片．
插入网页图片时，()中输入的是图片的网页链接地址：
网页图片：
输出效果：
简书
插入一张本地图片时，找到菜单栏的编辑－＞图片工具－＞插入本地图片．
以上两种方法达到的效果完全一样，此时，图片格式的()中记录的是插入的本地图片的绝对路径．
另外，在文件－＞偏好设置－>编辑器－＞图片插入处：
Screenshot from 2018-03-09 11-11-22.png
如果勾选优先使用相对路径，在此文档已经保存的前提下，图片格式中的()则记录的是以本文档所在文件夹问根目录的相对路径．
此外，在勾选了允许复制图片到指定文件夹选项的前提下，选择编辑－＞图片工具－＞当插入本地图片时－＞拷贝到文件夹...，此时选择图像拷贝的目标文件夹d-folder．
此后，每当使用前面插入本地图片的命令时，程序会自动复制原图片到d-folder文件夹，而且，图片格式中的()里面记录的是d-folder文件夹中图片的绝对路径．
所以，所有的图片都要先保存到本地硬盘，之后才可以进行插入操作．
无论以上哪一种方式，请记住：因为Markdown文件只是一个纯文本文件，图片格式中记录的只是获取图片的路径，当硬盘中的图片被删除或者被移动之后（或者将.md文件复制到别人的电脑上），.md文件中的所有插入的图片都将失效，显示不出来了．
这一点和Word的直接截屏－＞复制到剪切板－＞粘贴到Word相比，确实是一个短板，因为Word文件不是纯文本文件，它可以包含图像数据．
所以，为了防止以上图像失效的情况，最好是每次写完一个Markdown文档，就将其导出成PDF或者HTML格式，作为备份．
代码
插入代码的功能可能是Markdown文档最好用的功能之一了．
回想在Word中插入一段代码是什么效果？且不说语法高亮消失，显示效果也是十分丑陋．而在Markdown文档中插入代码的显示效果则几乎接近于专业的代码编辑器了，这一点使得Markdown文档用来写编程类的技术文档相当方便．
代码格式分为２类：
- 行内代码，或者说成小代码块，适用于在某一行中插入一小句代码．
- 代码块，当插入一段代码时，使用代码块语法．
行内代码使用` `标识，比如`cv2.namedWindow('image')`
代码块使用``` ```标识，比如：
输出效果：
cv2.namedWindow('image')
while(1):
cv2.imshow('image', img)
k = cv2.waitKey(1)
if k==27:
break
r = cv2.getTrackbarPos('R', 'image')
b = cv2.getTrackbarPos('B', 'image')
g = cv2.getTrackbarPos('G', 'image')
s = cv2.getTrackbarPos(switch, 'image')
if s==0:
img[:] = 0
else:
img[:] = [b, g, r]
cv2.destroyAllWindows()
分割线
使用三个*生成分割线：
***
输出效果：
参考文章：Typora For Markdown 语法。
网友评论