一、概述
宗旨
Markdown 的目标是实现「易读易写」。
可读性，无论如何，都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。
Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。比如：在文字两旁加上星号，看起来就像*强调*。Markdown 的列表看起来，嗯，就是列表。Markdown 的区块引用看起来就真的像是引用一段文字，就像你曾在电子邮件中见过的那样。
兼容HTML
MarkDown语法的目标是： 成为一种适用于网络的书写语言。
Markdown 不是想要取代 HTML，甚至也没有要和它相近，它的语法种类很少，只对应 HTML 标记的一小部分。
具体更多特性见Markdown 语法说明 (简体中文版),感谢作者团队的无私贡献。
语法简单
MarkDown相比于HTML只有少量的语法，很快就能上手写一些简单的md文件。接下来开始学习之旅～
二、基础用法
1、标题
Ⅰ、类 Atx 形式
在想要设置为标题的文字前面加#来表示。一个#是一级标题，二个#是二级标题，以此类推，支持六级标题。
Note：标准语法一般在#后面跟一个空格，在两个#行之间空一行代表是换行。不过并不是严格要求，开始写尽量按标准来较好。
eg:
# 一级标题
## 二级标题
result:
一级标题
二级标题
Ⅱ、类 Setext 形式
底线的形式，利用 =（最高阶标题）和 -（第二阶标题），两种符号数量不小于1。
Note:
-或=上一行必须有内容才能解析为标题。
eg:
一级标题
=
二级标题
------------
result:
一级标题
二级标题
2、字体
-
粗体： **<内容>**
-
斜体： *<内容>*
-
斜粗体： ***<内容>***
-
删除线： ~~<内容>~~
eg:
**粗体**
*斜体*
***斜粗体***
~~删除线~~
result:
粗体
斜体
斜粗体
删除线
3、引用
在引用的文字前加>即可，引用可以嵌套。可以用来引用某处的内容或者提供背景阴影效果，我经常用后者的功能...
eg:
> 一级引用
>> 二级引用
>>> 三级引用
result:
一级引用
二级引用
三级引用
4、分割线
三个或者三个以上的-或者*。
Note: 如果用
-，上一行有内容的话会被解析为类Setext形式的二级标题！
eg:
---
*********
result:
5、代码
- 单行代码： `<代码>`
- 多行代码： ```<代码>```
Note: 多行的情况下，可在第一个```后面加上语言名称，例如下例中的c
eg:
- 单行：
`int a=233;`
- 多行：
(``` c)
#include <stdio.h>
int main(int agc, char *agv[])
{
printf("hello mardown!\n");
return 0;
}
(```)
Note: 此处为了排版需要，加了括号,实际使用中去掉即可。
result:
- 单行：
int a = 233;
- 多行：
#include <stdio.h>
int main(int agc, char *agv[])
{
printf("hello mardown!\n");
return 0;
}
三、中级用法
1、超链接
用法为：[URL名称] (URL地址 "title")
Note: [ ] 与 ( ) 之间没有空格，title是URL的标题，当鼠标移到超链接上时显示的内容。title可加可不加。
eg:
[Jason416's Blog](https://jason416.tk)
result:
2、 图片
用法为：![图片alt] (图片地址 ''图片title'')
Note: [ ] 与 ( ) 之间没有空格；图片alt就是显示在图片下面的文字，相当于对图片内容的解释；图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加。
eg:
result:
图1. Miku
Note: 貌似简书上直接这样写，会提示图片上传失败~，光标定位到这，点上面工具栏的上传就好。会自动生成对应的图片URL链接，这个时候可以修改其他内容，规则跟上述一致。
3、列表
- 无序列表
用 - + * 中的任何一个字符都行，关键字跟内容之间要有一个空格。 - 有序列表
数字加上.
无序：
- 列表内容1
+ 列表内容2
有序：
1. 列表内容
2. 列表内容
result:
无序：
- 列表内容1
- 列表内容2
有序：
- 列表内容
- 列表内容
4、列表嵌套
用法为：上一级和下一级之间敲三个空格。有序和无序类似，可以穿插使用。
eg:
- 一级列表
1. 二级列表
result：
- 一级列表
- 二级列表
5、表格
语法为：
| 表头1 | 表头2 | 表头3 | ...
| -: | :-: | - | ...
内容1 | 内容2 | 内容 3| ...
第二行为表格格式控制行。
-表示列表内容，有一个便可；
:可标记文字对齐方式，放在-左边就是左对齐，其他类推，默认居中。
Note:
-与:之间没有空格！两边的|可以省略。默认对齐方式各平台有差异...
eg:
| 姓名 | 身高 | 年龄 |
| -: | :-: | - |
| 李四 | 175 | 18 |
result:
| 姓名 | 身高 | 年龄 |
|---|---|---|
| 李四 | 175 | 18 |
四、总结与致谢
经过在简书和自己博客上倒腾了，发现MarkDown解析器有些细微差别。比如对>的渲染效果都不一样，好像是hexo主题里的解析脚本应该跟简书的不太一样。不过大体效果是类似的。后期有时间再去研究，先在简书上记录吧，毕竟我比较懒，爱玩游戏。(*_*) 233。
非常感谢互联网上的朋友门的文章，也感谢为MarkDown默默做工作的人们~ 因为奉献，世界更加美好。
Together, make the world better!
网友评论