Markdown 语法简要
==
**本文没有使用csdn的markdown书写，而是原语法格式显示，便于更好的理解markdown语法。**
目前本人发现的比较不错的markdown编辑器：tepora、atom、Haroopad、以及在线版的cmdMarkdown、马克飞象、Stack Edit等。文章结尾附上本文的markdown形式。
<image url = '/path/to/image'>
简洁版Markdown语法
## 一、标题
`1. 类似Setext形式，利用 = 或 - 符号，写在标题文字下一行，分别表示一级、二级 标题`
注 : =或-至少也只需要两个就好。
`2.类似Atx形式，使用 # 符号，加与标题文字前，且至少一个空格才行使用个数1～6,分别表示六级标题`
注 : 标签语言讲究对称性，标题Atx模式可以在标题后加上不定个数的#，仅为美观而已。
markdown编辑文字需要有空行，才能显示为空行，而换行需要编辑时有一个空行
显示才会换行。编程通则，符号输入法英文半角。
## 二、区块引用
> markdown使用类似email中的 > 引用符号，标记区块
> 区块内的每一行都会自动添加 > 符号
> 其实也可以仅在第一行使用了 > 符号即可，不过有些编辑器会自动补上。
但是这样的话就需要有一个空行，才能表示区块结束。若是最后一行有 > 符号，
想要结束区块就要回车后，空一行，再回来哦，表示中断和区块编辑的联系。
>区块内也可以使用嵌套
> >嵌套层级应该是没有限制的
> >>多级嵌套
> >>也是挺好看的
> >但是想要结束一个小区块，就得借助空行了。
> >不然还真的不好结束呢。外层区块与其他区块之间，
> >看来需要有非区块语法隔离才行。
---
>使用了一个分割线才和上面的区块分开来，空格，空行，回车都没用的哦。
>区块内可以使用其他markdown的语法。
###### 来个标题
`背景条幅`
---
三个---即可形成一个分割线，注意和上面文字空一行，否则就成标题了哦
## 三、列表
+ 列表分为无序列表和有序列表，可以多级列表。
- 无序列表中使用 加、减、星号
* 来作为开启列表的标识,均需要有一个空格才生效。或者tab也行
9. 有序列表使用数字
6. 和英文的句号，数字不一定就要一二三的很有序。
7. 显示时候都是123的。
8. 多个段落的隔开，需要每个段前tab或4空格？有点乱，感觉首列后空一行
则每列都会空，非首列则空其后。
9. 列表内使用引用符号>，需要缩进
10. 还是列表内容
>引用，我似乎没感觉到？
7. 如果列表放入代码，该区快就要缩进两tab或8空格
```java
public static void main(String[] args){
System.out.pringtln("代码高亮");
}
```
1.可能无意间会写出列表形式，比如首行“2016. 09. 25"出现了数字，句点和空格
就会形成列表，如此可以加个\来避免，或者其他符号。
注意和普通文本的编辑不同，列表的缩进，需要在列表标识符号前加空格，最多三个。
其后面需至少一个空格或tab
2.文字段落前一个tab或4个空格，就会生成背景框。
`和用``符号似乎不太一样，这个有点加黑得样子？`
## 四、代码区块
1,代码区块得建立就是面所说，一个tab或者4个空格。
而在带码区块中，markdown的一般语法符号，将只是普通文本。
```java
public static void main(String[] args){
System.out.pringtln("代码高亮");
}//哎呦，后面的```引号，还不到能直接放在这一行呢，否则就不算结束代码块了。
```
## 五、分割线
在一行中使用三个或以上的星号、减号、下划线，就可以显示一个分割线
但是需要从行首就开始,可以混用,(不同的md编辑器，也许细节不同)且不必连续，但不能掺杂文字
----
___
_*-
而且要注意避免形成标题哦，
* * *
## 六、区段元素
#### 1、链接
Markdown 支持两种链接：行内式和参考式。链接文字都用[方括号]标记。
- 行内式，[]后跟(url "网址标题")即可。
[baidu](www.baidu.com "百度")，前面式显示网址，""内部式网址标题
* 似乎也可以使用路径形式,[file](/server/file/ "FTP服务器")。
- 参考式，两个[name][id]，前面为显示名称，id为标记变量名，在文章内任意文本首行位置
声明 [id]:www.baidu.com,即可。
*例如，[百度][url],网址在此显示，地址声明如下，
注意缩进什么的不要与其他语法冲突而失效。
[url]: www.baidu.com"baidu"
此种链接内容的格式，选择性的3个空格，一个冒号，一个tab或空格，然后是网址，
后面的标题title，可以用单引号，双引号，或者括号都行。
注，网址可以用<>包括，标题可以另起一行。链接不区分大小写，字母数字，空白和标点。
隐式链接标记功能，可以省略指定连接。此时视为文字为网址，[id]就空这，name等于id了。
- 如[Google][]
[Google]: www.google.com
如此形式，name可以多单词，加空格。
[thinkpad lenovo][],
[thinkpad lenovo]: www.lenovo.com
参考式链接可以像文献引用一样，放于文后，便于整洁。
## 七、强调
Markdown用\*或_来标识强调，位于其包围内的文本，被强调显示，两个\*\*或__,会更强吗？
此处为了显示单个的*而不是和后面的一起作用，用了\做转义。
+ 如下
- _单个强调_,和*强调单个*，是加黑斜体
- **双星强调**，__更厉害__
+ ****那么三星更厉害吗****,最多可用四个，但是没啥区别了。
____你____混合失效，且符号两边不能有空格。前边的不能空？
+ *强调单个*
- 删除线，~~nihao~~
## 八、代码及符号
原来背景`是用来标记小行段代码的`，用反单引号\``标记，代码写在其中。
要是代码内也有\``符号，那么外围可以多用几个\``符号
例如````这里面还有反单引号``出现呢````，成对出现的哦。
___
使用反引号时候，紧跟代码语言，即可实现代码高亮
最外围的\``` 内部各加一个空格，里面的引用就可以直接一开始添加更多的\```了
``` ``使用反引号 ```
$$注意使用标签标识符的时候，前后的位置个数要一致，尤其小心缩进与空格的影响$$
$d$
#d
$$你好#$$
$$nihao_$$
$$nihao^$$
$$nihao$$
$$nihao%$$
$$nihao@$$
$$nihao~$$
$$nihao{$$
1、markdown语法会自动规避一盒html的标签，比如&，[]之类的
## 九、图片
1、Markdown 使用和链接类似得方式处理图片，行内式和参考式，用！作为标记，加[name]和(path)
+ 行内式，![img1](/path/to/img1.jpg,"title"),小心写成链接哦
+ 参考式，![img2][image2]
[image2]: /path/to/image2.jpg
暂时没法指定宽高，可以用html的< image > 标签,此处加空格，否则就不显示了。颜色字体什么的
就看html的形式了。
## 十、其他
1、自动链接，Markdown 转译简短得自动链接或邮箱
<http://www.baidu.com/>,<markdown@mk.cn>
2、反斜杠，转义符号，可用于一下符号转义为普通
>\
>`
>*
>_
>{}
>[]
>#
>+
>-
>.
>!
>这几种符号得转义。
<! html 的标签，似乎会被隐藏,不同编辑器略有不同哦，<> >
空格空格加回车，才是换行符。
<text 这个标签就被隐藏了哦 >
### 表格
**Markdown Extra** 表格语法：独立行开始，写title，用|分割，然后次行用－符号，并配合|，如此构成表格。
| 项目 | 价格 |
| -------- | ----- |
| Computer | $1600 |
| Phone | $12 |
| Pipe | $1 |
可以使用冒号来定义对齐方式：
：---表示左对齐，---：表示右对齐，：---：表示居中对齐。
| 项目 | 价格 | 数量 |
| :------- | -----: | :--: |
| Computer | 1600 元 | 5 |
| Phone | 12 元 | 12 |
| Pipe | 1 元 | 234 |
- 试试表格，至少要有表头和一个－标识列才行哦。
表头|
-|
- 复选框，使用空格-/*/+空格[x]空格 项目，表示选中,类似列表选项。
* [x] 第一条
* [ ] 第二条
---
- 表情，使用冒号包围表情的英文代号
- 猴子:monkey:,星星:stars:,:v:
- 表情支持，见http://emoji.codes/
## 其他拓展
- CSDN
1. 脚注，类似链接，使用[^id]声明，其他地方[^id]:解释。
2. 目录，[toc]标签
3. UML图，类似代码块，不过反单引号后面申明的不是编程语言，而是图的类型
1. 如
```sequence
张三->李四: 嘿，小四儿, 写博客了没?
Note right of 李四: 李四愣了一下，说：
李四-->张三: 忙得吐血，哪有时间写。
```
2. 流程图
```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？
st->op->cond
cond(yes)->e
cond(no)->op
```
4. 列表的定义与基本语法不同，使用: 项目来缩进列表项。
5. 数学公式，如下
使用MathJax渲染*LaTex* 数学公式，详见[math.stackexchange.com].
- 行内公式，数学公式为：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$。
- 块级公式：
$$x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
- Gitlab
1、网址直译，www.baidu.com
2、文件对比，不同,使用花括号和中括号的配合
，不能同时使用同一个哦。{+ ADD +] and [-delete-}
3、gitlab引用，@user_name,#123,等等。
---
####CmdMarkdown [^cmd]
- 高效绘制 [流程图](https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown#7-流程图)，标识为flow
```flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
```
- 高效绘制 [序列图](https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown#8-序列图)，其标识为sequence
```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!
```
----
- 高效绘制 [甘特图](https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown#9-甘特图)标识为gantt
```gantt
title 项目开发流程
section 项目确定
需求分析 :a1, 2016-06-22, 3d
可行性报告 :after a1, 5d
概念验证 : 5d
section 项目实施
概要设计 :2016-07-05 , 5d
详细设计 :2016-07-08, 10d
编码 :2016-07-15, 10d
测试 :2016-07-22, 5d
section 发布验收
发布: 2d
验收: 3d
```
[^cmd]: jiaozhu
注：markdown可以直接使用许多html的标签，用于更为丰富的界面显示哦。
本人记录Markdown 语法用于个人学习，难免有疏漏，请读者见谅指点
本文参考[*Markdown*语法](http://www.appinn.com/markdown/),在此感谢。
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
