LI SIR - 个人博客
LI SIR
2021-12-30
目录

Markdown | 入门教程及书写风格

现代汉语就像用脏了的人民币，要用 Markdown 洗一洗。Markdown 是一种轻量级标记语言。你不需要关心标题多大字号、段前距多少、列表缩进几格，只要在纯文本前后增加一些标记符号（例如 # - * >），就能毫不费力地写出工整精美的文章。请注意！Markdown 不要写成 MarkDown。

# 优势

# 易学易记

只要几分钟就可以 学会 Markdown (opens new window)，然后你可能再也不想碰 Word 了。

# 专注写作

富文本编辑器（例如 Word）是通过点击图形化的功能按钮来实现排版，而 Markdown 则是通过标记字符去赋予文字不同格式。易读易写（easy-to-read and easy-to-write），让任何与文字打交道的人专注于写作，不用操心排版。

# 格式统一

同一份 Word 文档，在

  • 不同的设备：Windows、macOS、Android、iOS
  • 不同的版本：旧版 Word 、新版 Word
  • 不同的软件：Microsoft Office、WPS

可能显示不一样的效果。而 Markdown 可以 Write once, export everywhere。不管在电脑上，还是手机上，用 Markdown 写出来的文章都能带来舒适、统一、美好的阅读体验。

# 向外兼容

可以导出 PDF、 Word、HTML、图片等格式分享给没有安装 Markdown 编辑器的人。

# 入门

一开始你只要记住以下符号（英文半角状态），就能写出排版清爽的文章了。

标记符号 标记结果
# + 空格 + 文本 一级标题
## + 空格 + 文本 二级标题
### + 空格 + 文本 三级标题
- + 空格 + 文本 无序列表
1 + . + 空格 + 文本 有序列表
> + 空格 + 文本 引用
文本 + Enter + == 一级标题（不建议）
文本 + Enter + -- 二级标题（不建议）
# + 文本 + # 一级标题（不建议）
## + 文本 + ## 二级标题（不建议）

如果有些文字需要特殊说明：

标记符号 标记结果
** + 加粗 + ** 加粗
* + 斜体 + * 斜体
~~ + 删除线 + ~~ 删除线

# 进阶

以上就是最基础的 Markdown 语法，普通用户看到这里就可以开始动笔尝试了。下面介绍一些 Markdown 的书写风格，让你的源码和文档更精美，更有条理。你不必一下子全部记住，需要实现哪个功能再来查阅或者问 Google 也不迟。

# 标题

层级

  • 正文的标题从 ## 开始，# 要留给整篇文章的标题（也可以不写）。这样的大纲结构也可以很方便地转换为思维导图，也符合 SEO（搜索引擎优化）的规则。

    # 一级标题（h1）：文章的标题

## 二级标题（h2）：正文的大标题

### 三级标题（h3）：正文的小标题
    1
    2
    3
    4
    5

  • 虽然 Markdown 最大支持 ###### 六级标题，为了保持层级的简单，防止出现过于复杂的章节，请谨慎使用四级标题（除非是长文章）。如果三级标题下有并列性的内容，可以使用加粗、有序列表或无序列表代表末级标题。

    短文章的标题层级

### 正文的小标题

**三级标题 A**
- 论据 1（五级标题）
  - 细分论据 1（六级标题）
  - 细分论据 2（六级标题）
  - 细分论据 3（六级标题）
- 论据 2
- 论据 3

**三级标题 B**
1. 论据
2. 论据
3. 论据

**三级标题 C**
- 论据 1
- 论据 2
- 论据 3
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    长文章的标题层级

### 正文的小标题

#### 正文的三级标题 A

#### 正文的三级标题 B

#### 正文的三级标题 C
    1
    2
    3
    4
    5
    6
    7
    8
    9

  • 二级标题下，不能直接出现四级标题。

  • 标题要避免孤立编号（即同级标题只有一个）。

  • 标题要简短，结尾不带标点符号。

  • （源码上）标题前后空一行（段前距和段后距）。

  • 大标题和小标题之间要有内容过渡（引出或概括下文）。

    # Title

开门见山地告诉读者这篇文章讲什么？
一级标题作为文章的（页面）标题（H1），并且尽可能和文件名称保持一致。
如果文章很长，使用 [TOC] 生成目录。

## What

先定义问题是什么？……
正文从二级标题开始。

## Why

为什么会出现这样的问题？……

## How

下一步该怎么办？……

## See also

文末别忘了贴上参考链接。
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22

# 列表

# 无序列表

使用 ‐ 或 * 或 + 并跟随 1 个空格来表示无序列表。建议使用 ‐（连字符，hyphen）。

- 我是谁
- 我从哪里来
- 我到哪里去
1
2
3

不建议

* 我是谁
* 我从哪里来
* 我到哪里去

+ 我是谁
+ 我从哪里来
+ 我到哪里去
1
2
3
4
5
6
7

为什么

  • 星号 * 可能和加粗和斜体符号产生混淆。
  • 加号 + 不流行。

与其他语法结合使用

- **《春日》**：等闲识得东风面，万紫千红总是春。
- **《春草》**：萋萋总是无情物，吹绿东风又一年。
- **《墨梅》**：犹恨东风无意思，更吹烟雨暗黄昏。
1
2
3

预览

  • 《春日》：等闲识得东风面，万紫千红总是春。
  • 《春草》：萋萋总是无情物，吹绿东风又一年。
  • 《墨梅》：犹恨东风无意思，更吹烟雨暗黄昏。

# 有序列表

语法一（手动排序）

1. 斜月沉沉藏海雾，碣石潇湘无限路。
2. 不知乘月几人归，落月摇情满江树。
3. 春江潮水连海平，海上明月共潮生。
1
2
3

预览

  1. 斜月沉沉藏海雾，碣石潇湘无限路。
  2. 不知乘月几人归，落月摇情满江树。
  3. 春江潮水连海平，海上明月共潮生。

对于比较短的、很少修改的有序列表，请按顺序标号，保持源码的可读性。

语法二（自动排序）

对于比较长的、可能会修改的列表（尤其是很长的嵌套列表），请使用「懒人编号法」。纵使有新的列表项「插队」，把序号弄乱了也没关系，Markdown 编辑器自动会对序号进行纠错。

1. Foo.
2. Bar.
    1. Foofoo.
    2. Barbar.
    3. Gargar
3. Baz.
1
2
3
4
5
6

预览

  1. Foo.
  2. Bar.
    1. Foofoo.
    2. Barbar.
    3. Gargar
  3. Baz.

# 嵌套列表

缩进 2 ~ 4 个空格或一个 Tab（推荐），可以嵌套列表。

示例一

1. 不知乘月几人归，落月摇情满江树。
    - 与君吟弄风月，端不负平生。
    - 对秋深，离恨苦，数夜满庭风雨。
    - 五月畲田收火米，三更津吏报潮鸡。
2. 人姝丽，粉香吹下，夜寒风细。
    - 弓弦抱汉月，马足践胡尘。
    - 寒月悲笳，万里西风瀚海沙。
    - 东堂坐见山，云风相吹嘘。
3. 沅溪夏晚足凉风，春酒相携就竹丛。
    - 白发渔樵江渚上，惯看秋月春风。
    - 归来独卧逍遥夜，梦里相逢酩酊天。
    - 致君尧舜上，再使风俗淳。
1
2
3
4
5
6
7
8
9
10
11
12

预览

  1. 不知乘月几人归，落月摇情满江树。
    • 与君吟弄风月，端不负平生。
    • 对秋深，离恨苦，数夜满庭风雨。
    • 五月畲田收火米，三更津吏报潮鸡。
  2. 人姝丽，粉香吹下，夜寒风细。
    • 弓弦抱汉月，马足践胡尘。
    • 寒月悲笳，万里西风瀚海沙。
    • 东堂坐见山，云风相吹嘘。
  3. 沅溪夏晚足凉风，春酒相携就竹丛。
    • 白发渔樵江渚上，惯看秋月春风。
    • 归来独卧逍遥夜，梦里相逢酩酊天。
    • 致君尧舜上，再使风俗淳。

示例二

- 栏目

    > - 排版美学
    > - 数字生活
    > - 日志随笔

- 联系方式

    > - Email：***@gmail.com
    > - Telegram：t.me/***
    > - WeChat：***
1
2
3
4
5
6
7
8
9
10
11

预览

  • 栏目

    • 排版美学
    • 数字生活
    • 日志随笔

  • 联系方式

    • Email：***@gmail.com
    • Telegram：t.me/***
    • WeChat：***

Tips

  • Tab 缩进一级
  • Shift + Tab 提升一级

# 任务列表

语法

- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉
1
2
3
4
5

预览

  • [ ] 纯牛奶
  • [x] 西瓜
  • [ ] 鸡蛋
  • [x] 保鲜膜
  • [ ] 猪肉

# 引用

在每一行使用 > 符号，包括换行的句子。

> 我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
> by 毛泽东：《为人民服务》（1944 年 9 月 8 日）
1
2

我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。 by 毛泽东：《为人民服务》（1944 年 9 月 8 日）

# 表格

语法

| 左对齐             |                        居中对齐                        | 右对齐 |
| :----------------- | :----------------------------------------------------: | -----: |
| **加粗**           |           [插入链接](https://blog.lisir.me/)           |   ￥5.7 |
| `换行`<br />下一行 | ![插入图片](https://img.lisir.me/image/my/favicon.png) |  ￥10.4 |
1
2
3
4

预览

左对齐 居中对齐 右对齐
加粗 插入链接 (opens new window) ￥5.7
换行
下一行		 插入图片 ￥10.4

注释

  • Markdown 是轻量级的标记语言，所以不支持合并和拆分单元格。对于复杂表格，你可以在 Markdown 编辑器中使用 HTML 的 <table> 标签标记。
  • 输入 <br /> 可以换行（但不建议使用）。
  • 把 Excel 表格复制粘贴到某些 Markdown 编辑器可以直接转换为 Markdown 形式的表格。

# 链接

语法

[LISIR](https://blog.lisir.me/)
1

预览：LISIR (opens new window)

# 图片

语法

![插入图片](https://img.lisir.me/image/my/favicon.png)
1

预览

插入图片

Markdown 是一种纯文本标记语言，图片功能注定是它的弱项。

网络图床

但谁能保证哪个图床服务不倒闭？所以我在写作的时候，力求用文字把事情解释清楚，能不插入图片就不插入图片。我偶尔会用到的 图床 (opens new window) 是 sm.ms（免费）。

# 代码

# 行内代码

用 2 个重音符 `（backtick，在 Tab 键上方）包裹

`Markdown` 是一种轻量级标记语言。
1

预览

Markdown 是一种轻量级标记语言。

用两个 ` 包裹，才能显示 `：

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``
1
2
3

预览

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

重音符前后空一格

- 推荐：使用键盘快捷键 `Ctrl + D` 可以将当前网页保存为书签。
- 反对：使用键盘快捷键`Ctrl+D`可以将当前网页保存为书签。
1
2

预览

  • 推荐：使用键盘快捷键 Ctrl + D 可以将当前网页保存为书签。
  • 反对：使用键盘快捷键Ctrl+D可以将当前网页保存为书签。

# 代码块

将 3 个重音符 ` 置于代码块的首行和末行。首行的重音符后面可接代码语言名称，例如 ``` python，以达到相应的代码高亮效果。

```python
print "Hello, Python!"
1
2

预览

print "Hello, Python!"
1

diff 代码对比

```diff
function addTwoNumbers (num1, num2) {
-  return 1 + 2
+  return num1 + num2
}
1
2
3
4
5

预览

function addTwoNumbers (num1, num2) {
-  return 1 + 2
+  return num1 + num2
}
1
2
3
4

# 换行

以下键盘快捷键（语法）可能仅支持 Typora。

Enter = 换行 + 空行 = (Shift + Enter) × 2。

即按下回车键创建一个新段落（段与段之间加入空行）。

# 软换行

Shift + Enter = 换行（但是不会产生空行）。

`enticing` [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的
- Her neck was short but rounded and her arms plump and enticing. `Shift` + `Enter`
  她的脖子短，但浑圆可爱；两臂丰腴，也很动人。by 《飘》 `Enter`

- This was enticing to Wozniak, even more than any prospect of getting rich. `Shift` + `Enter`
  这句话对沃兹尼亚克的诱惑太大了，比变成富人的诱惑还要大。by 《乔布斯传》 `Enter`
1
2
3
4
5
6

enticing [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的

  • Her neck was short but rounded and her arms plump and enticing.

    她的脖子短，但浑圆可爱；两臂丰腴，也很动人。by 《飘》

  • This was enticing to Wozniak, even more than any prospect of getting rich.

    这句话对沃兹尼亚克的诱惑太大了，比变成富人的诱惑还要大。by 《乔布斯传》

# 硬换行

在行末使用空格（两个以上） + 换行（Enter），就可以实现强制换行，此语法适用于大部分 Markdown 编辑器。

硬换行在文档被导出时将被保留，且没有换段的段后距。

假如生活欺骗了你，  （两个空格）
不要悲伤，不要心急！  （两个空格）
忧郁的日子里须要镇静：  （两个空格）
相信吧，快乐的日子将会来临！  （两个空格）
心儿永远向往着未来；  （两个空格）
现在却常是忧郁。  （两个空格）
一切都是瞬息，一切都将会过去；  （两个空格）
而那过去了的，就会成为亲切的怀恋。  （两个空格）
by 普希金
1
2
3
4
5
6
7
8
9

假如生活欺骗了你，
不要悲伤，不要心急！
忧郁的日子里须要镇静：
相信吧，快乐的日子将会来临！
心儿永远向往着未来；
现在却常是忧郁。
一切都是瞬息，一切都将会过去；
而那过去了的，就会成为亲切的怀恋。
by 普希金

# 其他

名称 语法 备注
分割线 ---、***、+++ 不常用
内容目录 [TOC] Table of Contents

# 应用

Markdown 的用途很广。Write once, export everywhere：写博客、写邮件、排推文、做 PPT 等。

# 公众号排版

# 简历排版

# 邮件排版

Markdown Here (opens new window) 是一个浏览器扩展插件，可以将浏览器中编辑器（例如 email 正文）里的 Markdown 文本转换成渲染过后的 HTML，并且支持自定义 CSS。

修改 CSS 样式教程：

# 转换为 Mind Map

# 从网页导出 md 格式

借助浏览器插件 简约 (opens new window) 导出 md 格式的网页，不用 手动添加标记符号。

# 导出漂亮的 Markdown 源代码图片

  1. 打开 carbon.now.sh (opens new window)
  2. 语言选择 Markdown
  3. 书写或者粘贴 Markdown 源代码
  4. 导出 PNG 像素图或者 SVG 矢量图
#Markdown
上次更新: 2024/10/14, 19:46:59

← Docker 管理工具 Portainer→

最近更新
01
Git | 学习笔记（待更新）
10-06
02
使用 ACME 申请证书
09-28
03
Java | 第一阶段
04-27
更多文章>
Theme by Vdoing | Copyright © 2020-2024 By LI SIR