主打就是一个 5 分钟学会 Markdown

📺 已制作视频

主打就是一个 5 分钟学会 Markdown

成为一个程序员的标志是什么？我认为是从排斥 Markdown 到接受它。

为什么是 Markdown？

Markdown 到底有什么好处，能够让它成为全世界程序员群体最流行的笔记方式？

首先，我们先了解 Markdown 是什么？

Markdown 是一门正儿八经的编程语言，比如要对文本加粗，只需要在文字前后加两个星号 **，比如：**我很粗**，效果如下：我很粗。

你说这有什么优势？我一个富文本加粗按钮分分钟秒杀。

But，从操作来说，富文本加粗的过程是这样的：

1. 手移动到鼠标上；
2. 鼠标选中要加粗的那一行文本；
3. 鼠标移动到加粗按钮；
4. 点击按钮；
5. 手放回键盘。

对比下，Markdown 加粗的过程仅靠键盘输入即可完成，并且加上程序员（排除部分水货）打字速度飞快，以及对编程语法的高接受度，这几样原因共同促使了 Markdown 在编程界的出圈。

常用语法

Markdown 的常用语法看起来挺多的，但多用几遍就很熟悉了：

1. 加粗： **加粗**
2. 斜体: *斜体*
3. 删除：~~删除~~
4. 无序列表

- 我是第一行
- 我是第二行
- 我是第三行

效果如下：

• 我是第一行
• 我是第二行
• 我是第三行

5. 有序列表

1. 我是第一行
2. 我是第二行
3. 我是第三行

效果如下：

1. 我是第一行
2. 我是第二行
3. 我是第三行

---

6. 分割线：---，效果如上

7. 文字引用

> 引用我

效果如下：

引用我

8. 地址链接，点我点我：[Yopth](https://yopth.github.io/)
9. 图片引用：![Alt](https://i-blog.csdnimg.cn/blog_migrate/8f1b213356ed81d5a706d52c6ab7cb6d.png)
   
10. 行内代码：var msg = 'Hello World

笔者用 Markdown 写的本文，不太好演示代码块，上图片：

用反引号包括起来内联代码

11. 块级代码：

var msg = 'Hello World
console.log(msg)

前后三个反引号，第一行可以加上指定语言，比如这上图的 javascript。

再加上六级标题：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

以上的语法基本解决 80% 的常用场景，剩下的就是 20% 不常用的。

20% 不常用的

这些 20% 不常用的（对个人来说），笔者平时在用这些的时候，也都是得查一下笔记或者百度一下，这里简单描述一下 Markdown 的高级不常用用法：

表格

项目     | 价格
-------- | -----
电脑  | $1600
手机  | $12
导管  | $1

效果如下：

项目	价格
电脑	$1600
手机	$12
导管	$1

Markdown将文本转换为 HTML。

LaTeX 数学公式

KaTex 文档

Gamma公式展示 $\Gamma(n) = (n-1)!\quad\forall
n\in\mathbb N$ 是通过 Euler integral

$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过 Euler integral

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

插入甘特图

Gantt 文档

插入UML图

UML 文档

插入Mermaid流程图

Mermaid 文档

插入Flowchart流程图

Flowchart 参考文档

插入classDiagram类图

Class Diagram 参考文档

注脚

一个具有注脚的文本。[^1]

[^1]: 注脚的解释

效果如下

一个具有注脚的文本。¹

用什么软件写 Markdown 呢？

Markdown 软件非常多，大体上分为两类，一种是双屏编辑器，即一边编写 Markdown，另一边是预览，比如 VSCode：

还有各类博客平台，比如 CSDN、博客园、掘金等等。

另外一种是实时渲染，输入后立即显示样式，比如 Typora ：

还有 Zettlr、飞书文档等等。

笔者用过很多 Markdown 编辑软件，除了上面之外还有语雀、印象笔记、Notion等等，我之前甚至重度使用有道云笔记和 Typora，但 Markdown 有一个非常大的痛点——图片。是的，Markdown 是需要自己去处理图片的，它其实只接受一个图片 URL，所以就需要自己去维护一个图床，也就是图片的存储并得到一个 URL。

维护图床是一个头疼的事情，一开始是放在本地，用相对路径去引用，但是当我想将写好的 Markdwon 发表到博客平台上后，我发现图片要全部手动上传一遍，非常辛苦。

后来就试着用 GitHub 当图床，但是 GitHub 大家都懂的，容易图片加载失败，仓库容量也有上限。

之后就是白嫖一些免费的图床平台，后来发现也是容易加载失败，图片大小卡得很严，要想稳定还是得花钱购买它的服务。

为了几张照片要花费时间精力去维护一个图床有点不值当，于是直接用博客平台了，现在主力就是在 CSDN 上写 Markdown，由 CSDN 自己去维护图床，虽然 CSDN 的编辑器和样式挺 ugly 的，但程序员不都往往最后来一句——“能用就行”。

---

1. 注脚的解释 ↩︎