1 基本语法

Markdown是一种轻量级标记语言，使用纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。

文件后缀：.md, .markdown

支持markdown的网站：有道云笔记、印象笔记、博客园、GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等

写在前面的注意事项：

注意：在markdown，由于|,#等字符已经用于markdown格式,如果正文中需要使用这些符号，可以在前面加上一个\，类似c语言prinf("\t\n")的作用

转义字符: \

例如：下划线语法:
  这是++下划线++
预览：这是++下划线++
加上转义符：
  这是\+\+下划线\+\+
预览：这是++下划线++

1.1 标题

标题是每篇文章必备而且最常用的格式。

在Markdown中，如果想将一段文字定义为标题，只需要在这段文字前面加上 #，再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题，总共六级，只需要增加 # ，增加一个 # ，标题字号相应降低一级。如图：

#1 这是一级标题
#2 这是二级标题
#3 这是三级标题
#4 这是四级标题
#5 这是五级标题
#6 这是六级标题

预览：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

1.2 列表

列表格式也很常用，它可以让你的文稿变得井井有条。在 Markdown 中，你只需要在文字前面加上 - 就可以了；如果你希望是有序列表，在文字前面加上 1. 2. 3. 即可。

注：-、1.和文字之间要保留一个字符的空格。

无序列表：

- one
- two
- three

预览：

one
two
three

有序列表：

1. one
2. two
3. three

预览：

one
two
three

1.3 引用

如果你需要在文稿中引用一段别处的句子，那么就要用到「引用」格式。

在引用文字前加上 > 并与文字保留一个字符的空格，即可。

> 这是引用

预览：

这是引用

>可以和其他语法搭配使用，例如：

1.1.4 字体样式：粗体斜体等

Markdown 的粗体和斜体也非常简单：

用两个 * 包含一段文本就是粗体的语法；

用一个 * 包含一段文本就是斜体的语法。

用两个 = 包含一段文本就是高亮的语法。

- 这是**粗体**
- 这是*斜体*
- 这是~~中划线~~
- 这是++下划线++
- 这是==高亮==

预览：

这是粗体
这是斜体
这是~~中划线~~
这是++下划线++
这是高亮

更多字体样式可以通过嵌入html解决，但并非所有markdown插件都支持

例如

<html>
I'm <span style="color:red">red</span>
</html>

I'm red

1.5 链接与图片

语法格式：

链接：[显示文本](链接地址)

图片：![替换文本](图片链接地址)  或 ![](图片链接地址)

插入图片的语法和链接的语法很像，只是前面多了一个！

示例：

链接：[点击进入我的博客首页](https://www.cnblogs.com/jdmw/)

图片：![image](https://www.cnblogs.com/images/logo.svg?v=R9M0WmLAIPVydmdzE2keuvnjl-bPR7_35oHqtiBzGsM)

示例：

链接：点击进入我的博客首页

图片：

插入图片的语法，[]里面的文本虽然可以为空，但建议加上文本如[image],这样在查看markdown时可以直观地看出这是一个图片。

1.6 分割线

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

语法格式，

---


***

* * *

*****

- - -

----------

预览：

结束预览

1.7 表格

示例：

姓名 | 爱好
---|---
张三 | 音乐
李四 | 艺术

预览：

姓名	爱好
张三	音乐\|舞蹈
李四	艺术

重要经验：如果表格内容需要包含markdown标记语法字符（如“|”），可以使用“\”转义。

例如：

姓名 | 爱好
---|---
王五 | 音乐\|舞蹈

预览：

姓名	爱好
王五	音乐\|舞蹈

2 插入html

语法格式：

<html>
<center>This is html</center>
</html>

预览：

This is html

示例：插入svg图片（部分平台支持）

<html>
<table>
  <tr>
    <td>
      <svg width="140" height="170">
        <title>SVG Sample</title>
        <desc>This is a sample to use SVG in markdown on the website cnblogs.</desc>
        <circle cx="70" cy="95" r="50" style="stroke: black; fill: none;"/>
      </svg>
    </td>
  </tr>
</table>
</html>