MarkDown入门的基础语法

概述

设计理念

Markdown 致力于使阅读和创作文档变得容易. 是用于 创作 web 文档的.

Markdown 从不想取代 HTML，也没有要和它相近，它的语法集合非常小，只对应一小部分 HTML 标签. 它要做的 不是 创造一种新的语法以使插入 HTML 标签变得更容易。在我看来， HTML 已经很容易写了。Markdown 的目标是易于阅读, 创作和编辑文章. HTML 是一种 发布 格式; Markdown 是一种 创作 格式. 因此, Markdown 处理的都是纯文本。

块状元素

段落和换行

• 段落 ：就是连续的文本行
• 换行：Markdown不会自动换行（直接输入enter),需要在需要换行的文本行末尾加入两个空格再enter才可以实现换行
• 一个或多个空行划分不同的段落. (空行的含义就只要是看起来是空行就行了 – 即使包含了 spaces 或者 等空白符也是空行.) 普通段落不应该使用缩进。

标题

Markdown 支持两种形式的标题, [Setext] 1 和 [atx] 2.

• Setext 样式的标题使用的等号来表示一级标题, 使用连字符表示二级标题.任意长度的 = 或 - 都是可以的. 如

binge

binge2

• Atx 样式的标题每行开头使用 1-6 井号, 对应 1-6 级标题. # ,## ,### ···，但是最后一个#后要加个空格再加入标题文字

块引用

• 在每一个需要强制换行的段落的首行前面加上一个 >
• 块引用也可以嵌套 > >
• 块内部也也已加上标题，列表和代码块等元素

列表

列表分为有序表和无序表（表可以多层嵌套）

• 无序表：在文本行前加上 * - + 都可以，记得加上空格
• 有序表：在文本行前加上数字. ，记得加上空格

代码块

• markdown：原生 Markdown只需要将每一行都缩进 4 个空格或者 1 个水平制表符缩进即可生成代码区块，代码块自动扩展直到碰到未使用缩进的文本 (或者文章结尾）

• GFM(Github Flavored Markdown ) ：围栏式代码区块，在代码上下一行使用三个反引号 ```， 并在第一行反引号后自定义代码语种

水平分割线

如果一行中只有三个以上的连字符(-), 星号(*), 或者下划线(_)， 星号和连字符之间的空格也是允许的. 都会生成一条水平线:

内联元素

Markdown 支持两种链接形式: 行内式 和 参考式.这两种形式下链接文本的定界符都是 [中括号]

链接

• 行内式链接 ： 【链接文字】(链接网址 “标题”)

> [百度](https://www.baidu.com "baidu.com")   

百度

• 参考形式 : 为参考形式的链接定一个 [名称] 方便我们在文章中多次引用（链接名称可以用字母、数字和空格，但是不分大小写）。
  【链接文字】[标题]

> 遇到问题，可[谷歌][1],也可[百度][2],又可[bing][3]

[1]: https://www.google.com/ "Google"
[2]: https://www.baidu.com/ "Baidu Search"
[3]: https://cn.bing.com/ "Bing Search"

遇到问题，可谷歌,也可百度,又可bing

• 自动形式链接

https://www.baidu.com/ 

https://www.baidu.com/

强调

Markdown 将星号 (*) 和下划线 (_) 作为强调标记.

加粗： 四个*或者_包裹的内容为加粗 如：** binge **,*与文本间无空格

**binge**
__binge__

binge
binge

斜体 ： 两个或者_包裹的内容为加粗 如： binge *,*与文本间无空格

*binge*
_binge_

binge
binge

图片

通常, 要用 “原生” 的语法在纯文本格式中插入图片是很困难的.

Markdown 使用了类似链接的语法来插入图片, 包含两种形式:行内式和参考式（像链接）

• 行内式 ：
  ![Alt属性](图片URL "title")
  一个感叹号: !;
  紧跟着一对方括号, 包含了图片的 alt 属性;
  紧跟着一对圆括号, 包含了图片的 URL 或者路径, 以及一个可选的用单引号或双引号包裹的 title 属性.

![百度](https://i-blog.csdnimg.cn/blog_migrate/1722b5a02ba305e0f942c1ac75a22428.png)

• 参考式 !【链接文字】[ID]
  (中间要加空行)
  [ID] : URL “title”

![百度][1]
[1]: https://i-blog.csdnimg.cn/blog_migrate/1722b5a02ba305e0f942c1ac75a22428.png "百度"

拓展

反斜杠转义 ：

Markdown 中可以使用反斜杠转义 Markdown 语法符号为字面量. 例如, 如果你想用星号包围一个单词

*binge*
\*binge\*

binge
*binge*

Markdown 为下面字符提供反斜杠转义:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

表格：

表格由行列组成，第一行是表头，第二行指定表格内容布局，第三行开始为表格数据

• 同行之间用 | 分割不同的列，首尾也用。
• 同一张表格，各行的列数（单元格数）应该相同
• :- | :-: | -: 作为表格标题与内容的分割标志，同时控制内容的布局， :- 表示左对齐，相应的后两个为居中和右对齐， - 数量不限，- 默认为左对齐。

如：

| Left-标题     | Center-标题     | Right-标题  |
| :-            |     :-:        |        -:   |
|  b1           | b2             | b3          |
| d1            | d2             | d3          |

Left-标题	Center-标题	Right-标题
b1	b2	b3
d1	d2	d3