Markdown

什么是Markdown?

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

为什么我们要学习Markdown?

  • 因为编写的便捷性以及阅读的舒适性，它被广泛用于各种文档的编写。
  • 你可以在Github的任何规范的项目上看到它：一个带有.md后缀的说明文档，这是编写文档的官方语言。
  • 同时本博客的所有文章都基于Markdown编写。

基本技巧

代码

1
如果你只想高亮语句中的某个函数名或关键字，可以使用 `这里是你要包裹的代码` 包裹代码实现。

也可以使用 4 空格缩进，再贴上代码，实现相同的的效果

1
2
3
def g(x):
    yield from range(x, 0, -1)
yield from range(x)

标题

文章内容较多时，可以用标题分段：

1
2
3
4
5
6
7
8
标题1
======

标题2
-----

## 大标题 ##
### 小标题 ###

粗斜体

1
2
3
*斜体文本*    _斜体文本_
**粗体文本**    __粗体文本__
***粗斜体文本***    ___粗斜体文本___

链接

常用链接方法

1
2
文字链接 [链接名称](http://链接网址)
网址链接 <http://链接网址>

高级链接技巧

1
2
3
4
5
6
这个链接用 1 作为网址变量 [Google][1].
这个链接用 yahoo 作为网址变量 [Yahoo!][yahoo].
然后在文档的结尾为变量赋值（网址）

  [1]: http://www.google.com/
  [yahoo]: http://www.yahoo.com/

列表

普通无序列表

1
2
3
- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格]

普通有序列表

1
2
3
1. 列表前使用 [数字+空格]
2. 我们会自动帮你添加数字
7. 不用担心数字不对，显示的时候我们会自动把这行的 7 纠正为 3

列表嵌套

1
2
3
4
5
6
7
8
9
10
11
12
1. 列出所有元素：
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行：
    前面必须加四个空格，
    这样换行，整体的格式不会乱
3. 列表里引用：
    > 前面空一行
    > 仍然需要在 >  前面加四个空格
4. 列表里代码段：
前面四个空格，之后按代码语法 ``` 书写

引用

普通引用

引用文本前使用 [大于号+空格]
折行可以不加，新起一行都要加上哦
引用里嵌套引用

最外层引用

多一个 > 嵌套一层引用

可以嵌套很多层
引用里嵌套列表

  • 这是引用里嵌套的一个列表
  • 还可以有子列表
    • 子列表需要从 - 之后延后四个空格开始
      引用里嵌套代码块
同样的，在前面加四个空格形成代码块

图片

跟链接的方法区别在于前面加了个感叹号 !，这样是不是觉得好记多了呢？

![图片名称](http://图片网址)

换行

如果另起一行，只需在当前行结尾加 2 个空格

如果是要起一个新段落，只需要空出一行即可

分隔符

如果你有写分割线的习惯，可以新起一行输入三个减号-。当前后都有段落时，请空出一行：

1
2
3
4
5
前面的段落

---

后面的段落