Markdown 语法学习笔记①

发表于 2018-01-07 分类于学习笔记阅读次数：本文字数： 3.4k 阅读时长 ≈ 7 分钟

标题

两种语法，分别为类 Setext 和类 atx 形式。

类 Setext 式

利用 = 和 -：

标题
=====
标题
-----

类 atx 式

在行首插入 1 到 6 个#, 对应到标题 1 到 6 阶。

# 标题
## 标题
### 标题
#### 标题
##### 标题
###### 标题

也可以

# 标题 #
## 标题 ##
### 标题 ###

注意： 不要忘记#与标题文字间的空格
错误示范：##标题

区块引用

使用 >

> 一些文字

只需在每段第一行加上即可
还可以嵌套，只要根据层次加上不同数量的 >

> 一些文字
>> 一些一些文字

引用区域内可以使用其他 Markdown 语法：

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

列表

分为有序列表与无序列表。
如果列表项目间用空行分开，那么中间内容将不会被列表项包括在内。

* 列表项

* 列表项

如果要在列表项目内放进引用，那 > 就需要缩进

* 列表项
    > 引用

如果要放代码区块的话，该区块就需要缩进两次

* 列表项
        <codehere>

有序列表

使用 *,+ 和 - 标记

* 列表项
+ 列表项
- 列表项

无序列表

使用数字加英文句点. 的方式

1. 列表项
2. 列表项
3. 列表项

注意：

在列表标记上使用的数字并不会影响输出的顺序
~~简直智障福音啊~~

文字出现数字 - 句点 - 空白而要避免列表项出现，可以在句点前加上反斜杠\
eg:1986\. What a great season.

代码区块

只需简单地缩进一格（或四个空格）即可

这是文字

这是代码

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

同时，在代码区块中，一般的 Markdown 语法不会被转换。

分隔线

使用三个以上的 *、-、_来建立一个分隔线，可以在星号或是减号中间插入空格，但注意行内不能有其他东西

文字
***

文字
---

文字
___

文字
- - -

文字
* * *

链接插入

Markdown 支持两种形式的链接语法：行内式和参考式两种形式。
不管是哪一种，链接文字都是用 [] 来标记。

行内式

使用方括号 [] 括住所需加链接的文字，并在后面以圆括号 () 形式插入链接（可以是相对路径）。
如需加入链接描述 (链接的 title 文字) 只需在圆括号中的链接后以 "" 包起文字即可。

这是一个[链接](https://xsllen.tk)
这是一个有名字的[链接](https://xsllen.tk "Jim's Blog")

参考式

使用方括号 [] 括住所需加链接的文字，并在后面再接上一个方括号 [] 进行用于辨识链接的标记。
你也可以选择性地在两个方括号中间加上一个空格。

这是一个[链接][1]
这是一个[链接] [1]

接着，在文件的任意处把标记的文章内容定义出来。
链接网址还可以使用尖括号包起。
网址之后可以选择接着网址描述（title）内容，可以用单引号、双引号或是括弧包着。
网址描述（title）内容可以放到下一行，也可以加缩进，好看就行。~~（说得我闲得蛋疼一样）~~

[1]: https://xsllen.tk
[1]: <https://xsllen.tk>
[1]: https://xsllen.tk "My blog"
[1]: https://xsllen.tk 'My blog'
[1]: https://xsllen.tk (My blog)

[1]: https://xsllen.tk 
"My blog"

注意：
1. 链接辨别标签可以有字母、数字、空白和标点符号，但是 ** 并不区分大小写！** 因此以下两个链接是相同的。

[link text][a]
[link text][A]

2. 标记方括号内的内容可以省略（即后一个方括号为空），此时链接标记会视为等同于链接文字。

[link][]
相当于
[link][link]

参考式整体实例：

I get 10 times more traffic from [Google] [1] than from[Yahoo] [2] or [MSN] [3].

[1]: http://google.com/        "Google"
[2]: http://search.yahoo.com/  "Yahoo Search"
[3]: http://search.msn.com/    "MSN Search"

如果改成用链接名称的方式写：

I get 10 times more traffic from [Google][] than from[Yahoo][] or [MSN][].

[google]: http://google.com/        "Google"
[yahoo]:  http://search.yahoo.com/  "Yahoo Search"
[msn]:    http://search.msn.com/    "MSN Search"

文字处理

斜体

使用一个 * 或_符号将文字包围起来。

*斜体文字*
_斜体文字_

加粗

使用两个 * 或_符号将文字包围起来。

**加粗文字**
__加粗文字__

粗斜体

使用三个 * 或_符号将文字包围起来。

***粗斜体文字***

删除线

使用两个 ~ 符号将文字包围起来。
~~带删除线的文字~~

注脚

使用 [^keyword] 表示注脚，并在文本的任意地方对该注脚定义（类似与参考式）
示例：

这里有一个注脚[^footnote]。
[^footnote]: 这是那个*注脚*的**文本**。

效果：

这里有一个注脚 ^[1]。

注意： 使用什么符号开启标签，就要用什么符号结束。

代码标记

使用反引号 ` 将代码文字包起.

`<code>code here!</code>`

注意：
如果要在代码区段内插入反引号，应使用多个反引号来开启和结束代码区段。
``code`code``
代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号.
  `` ` ``
  `` code`code ``
在代码区段内，& 和方括号都会被自动地转成 HTML 实体。

图片插入

与链接插入类似，同样包括两种方式：行内式与参考式。

行内式

使用 ![alt text](图片网址)
还可以加上图片描述（title 文字）
![alt text](图片网址 "描述文字")

参考式

使用 ![alt text][id]
「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：

[id]: 图片路径 "描述文字"

注意： 到目前为止， Markdown 还没有办法指定图片的宽高，需要的话可使用普通的 <img> 标签

内容目录（TOC）

在段落中填写 [TOC] 以显示全文内容的目录结构。

效果：
[TOC]

表格

示例：

| 项目        | 价格   |  数量  |
| --------   | -----:  | :----:  |
| 计算机     | \$1600 |   5     |
| 手机        |   \$12   |   12   |
| 管线        |    \$1    |  234  |

效果：

项目	价格	数量
计算机	$1600	5
手机	$12	12
管线	$1	234

待办事项及 TODO 列表

使用带有 - [ ]（未完成）或 - [x]（已完成）项的列表语法撰写一个待办事宜列表，并且支持子列表嵌套以及混用 Markdown 语法。
示例：

- [ ] 写一个个人主页
- [x] 写一个Maekdown学习笔记$$

效果：

写一个个人主页
写一个 Maekdown 学习笔记

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只需用方括号括起即可，Markdown 就会自动把它转成链接。

<http://example.com/>
<[email protected]>

效果：
http://example.com/
[email protected]

反斜杠用法

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

HTML 兼容性

Markdown 文档内可任意使用 html 语句。
（你想在 Markdown 文档里码 HTML 也没问题的 233）
Markdown 文档会对特殊字符自动转换，如 < 和 &。

文章过长折叠（hexo 用）

使用 

这是那个注脚的文本。 ↩︎

标题