markdown常用知识点

为什么要用markdown写开发文档？

1.可以在git上在线预览，docx文档需要下载才能看见；

2. .md文档每次修改之后能被git管理，可追踪修改内容和修改人，但是docx不能追踪修改内容。

兼容HTML

1.在HTML区块内，写markdown的样式，是不生效的
但是markdown的语法是生效的

2.HTML中 '< ' 和 '& '需要特殊处理才能显示 "&lt;" "&amp;"
markdown中：
在代码范围内，markdown不会将特殊符号转换为"&lt;" "&amp;"，
在文档范围内出现markdown自动会转换为"&lt;" "&amp;"

3.markdown中空行 或者 多个空格加回车 表示空行

4.markdown标题两种展现方式
一级标题
===========
二级标题
--------
#一级标题
##二级标题

5.markdown的区块引用 ">"

多个>代表层级关系，>可以给每句话强制性断行

6.markdown只支持有序列表和无序列表

无序列表用：* + - 作为列表标记

有序列表用：1. 数字加英文句点作为列表标记

7.markdown中建立代码区块，只要缩进4个空格或1个制表符，markdown会自动用<pre>和<code>标签把代码区块包起来。

代码区块内，markdown会将特殊的字符，"<" "" "&"转换成HTML实体。

8.分隔线
markdown可以在一行内用三个以上的 * - —

9.markdown中链接文字都是用[ ]来标记（）紧跟网址链接

10.markdown使用“*”和“_”作为强调字词的符号。一个表示markdown会转换成<em>斜体，两个符号会转成<strong>.注意符号要成对出现

11.用反斜线“”使特殊符号不被markdown转义，直接展示出来

12.在行内展示一小句代码，用反引号包起来“``”

13.markdown插入图片格式（无法指定图片宽高）
![图片替代的文字]（图片的路径）

14.一般网址用尖括号包起来 <http://example.com/>

markdown会将其转化为<a href="http://example.com/">http://example.com/</a>