Markdown的一些杂谈

前言

本篇博客将围绕一种常用的文件——Markdown文件来写。由于Markdown以一种类似代码的形式来格式化文本内容，因此可以较为方便地调整你的笔记，让它看上去更加美观一些。

对于Markdown的使用，笔者其实也才刚刚入门，所以如果有写的不对的地方，多多包涵。

准备工作

软件：【参考版本】有道云笔记

官网下载地址https://note.youdao.com/**当然使用Markdown的官方软件也是可以的，但是毕竟是国外的软件，下载和使用不太方便，感兴趣的朋友可以自行了解**

系统版本：****Win10/11/其他非Windows版本

我的电脑是Win10的版本，仅供参考

认识.Md文件

.md是Markdown文件的标准存储格式，如果之前有VS code的使用经历的话，系统应该默认会使用VS code打开这类文件。

VS code真的很强大，扩展很多，很多文件都可以使用VS code打开。

在VS code的解析下，.md文件应该长这个样子：

我们待会儿需要使用有道云笔记编辑这类文件，没有VS的朋友也不用着急

为什么使用Md？

先举个例子吧，现在我们有一段这样的示例文本：

大标题
小标题1
内容1

小标题2
内容2

小标题3
package 某个包

System.out.println("某段示例代码");

这段示例文本由以下四种类型的笔记组成：

1. 一级标题
2. 二级标题
3. 普通文本内容
4. 示例代码（这里是一段java代码）

在文本文档中，我们只能做到以下的效果：

可以看到，无论是示例的四种文本中的哪一种，文本文档中显示的内容格式都是完全相同的，没有层次感和优雅的格式。

这时可能会有朋友说，可以用Word来实现示例笔记的效果：

其实说的也没错……

但是我们学前端的，一定绕不开一个名词：超文本标记语言（HyperText Mark Language, HTML） ，关于HTML的相关知识我在其他的博客会讲，现在只需要知晓这个名词。

而Markdown也是一种轻量级的、可由纯文本格式编辑的标记语言。

最主要的是，它可以轻松地转化成HTML语言，而且很多HTML的效果可以直接像在浏览器中的一样，在Md文件中展示出来。

这是因为Md可以直接解释HTML的代码，在网页上呈现笔记的效果。

另外，它也可以转化为常见的word，pdf等文件。

目前，市面上流行的很多写作语言，都是基于Markdown来写的，包括CSDN，Github等论坛。

所以，对于开发者而言，掌握Markdown的基本使用是相当重要的。

我们的示例文字，使用Markdown文件，呈现出来的效果是这样的：

是不是有点博客的味道了？ 就作为笔记而言，这样看起来也更加优雅了。

怎么使用Md？

如果是和博主一样，使用有道云笔记，在左侧边栏里按照“全部笔记”->“我的资源”的顺序打开。相对位置如下：

*web学习是我自己的文件夹哈 *

右键点击我的资源，按照“我的资源”->“新建”->“Markdown”的顺序创建一个新的Md文件：

下面其实就可以开始编辑了， 但是要确保你在右上角的这个位置选择了“所见即所得”这个模式。

接下来的用法，就和Word和CSDN博客的编写差不多了，直接选文本格式，调成自己喜欢的样子就可以了。

在内容编辑完成之后，回到左侧侧边栏，右键你的Md文件，选择下载即可。

初次使用有道云笔记的朋友需要注意，如果不下载，你的文件是保存在云端的。

如果从本地直接拖一个文件夹进来编辑Md文件，当然是可以的，但是结果是不会自动同步到本地的哈。

怎么看别人给我的Md文件？

现在不少开发者都会使用Md文档来记录东西，就比如说我学习前端的这里，教学编程的老师也喜欢使用Md文件来整理笔记。

这些笔记常常会和代码文件放在一起。如果你在编译器（比如VS code或HbuilderX）里查看代码的时候，想顺带喽一眼笔记的内容，打开可能是下面这个场面：

这个效果显然是不太好的，如果每一篇博文（或者说笔记）都长这个样子，着实有点难受了。

那么，如何正确地查看Md文件呢？

打开有道云笔记，左键单击“我的资源”（或者新建一个文件夹，或者直接从本地拖一个文件夹/复制一个文件夹），可以看到这样一个界面。

直接将目标Md文件从你的资源管理器中拖动到右侧空白区域即可。

这个时候再单击打开，查看Md文件，就可以看到格式排版正确的Md文件了。

*这些HTML的笔记我会在整理完之后分几篇专门的博客来发，有需要的可以期待一下 *

Md文件命令

可能很多人看到“标记语言”这种说法，会认为Markdown就是像HTML或者XML那样，需要掌握诸如“标签”、“元数据”等等大量代码有关的东西。

对此我会说，的确，但是其实并没有想象中那么艰难。

首先，就拿有道云笔记来说，即使什么命令都不知道，也可以像正常记笔记、写博客一样编辑Md文件。

其次，就算学，基本的Md命令也并不是很多。下面，我将分享如何学习Md命令。

切换模式

新建一个Markdown文件，在刚刚设置“所见即所得”的地方，将模式切换为分屏编辑：

此时，左侧的黑色区域就是像VS code一样，用来编写代码的地方；右侧则为效果的预览。

特别的，左边区域的主题颜色是可以调整的，点击右上角那个像衣服一样的图标，选一个自己喜欢的颜色即可。我的是tomorrow_night_eighties，仅供参考。

看到最上面的工具栏了吗，我们依次来看每一个选项对应的效果和代码（从左至右）。

粗体、倾斜、下划线、删除线和荧光标记

点击最左边的字母B，它代表的是粗体效果，此时会出现下面这组标签：

** **

这一对标签由两组“***”组成，在他们的中间填上文字（内容*），在右侧的预览中就可以看见加粗的效果。

同样的，斜体文字、下划线文字、删除线文字以及荧光标记的代码和对应的效果如下：

* *

++ ++

~~ ~~

== ==

分级标题

在工具栏中，“H”字样代表标题，在下拉菜单中可以选择标题的等级，1~6级的代码和对应的效果如下：

#

##

###

####

#####

######

注意，命令中的#和标题的内容一定要空格分开，否则将无法识别#命令。

水平线

水平线可以用来划分笔记的区域，其代码和对应的效果如下：

---

引用

如果想在笔记中引用一些内容，以单独的区域展示出来，使用的代码和对应的效果如下：

>

也可以在每一行引用内容前都加上“>” ，不过要注意，非引用部分要和引用部分以空行分开。

无序和有序列表

有时，我们还需要在笔记中插入一些列表，用于要点记录内容，这时就可以用到无序和有序列表。

无序列表和有序列表的代码分别如下：

-

1.

注意，命令符号和文本之间依然要隔一个空格。

在实际情况中，常常还要用到多级标题。多级标题的方式是，换行，并且按一次tab键（一个\t），然后再使用“ - ”或者“ 数字 + ‘.’ ”，就像下面这样：

- 一级
    - 二级

1. 一级
    1. 二级1
    2. 二级2

代码和对应效果如下：

任务清单

任务清单，也就是任务是否完成的情况记录，完成了就在方框里面打个勾，实现“未完成项目”和“已完成项目”的命令和效果如下：

- [ ] 

- [x] 

插入链接和图片

如果想在笔记中插入一段链接，也是很好办的，示例代码和效果如下（网址就用CSDN吧）：

[这里面是链接显示的文字](这里面填链接的网址)

如果想要插入一张图片，格式和插入链接是类似的，代码和展示的效果如下：

![这里的文字选填](你的图片的链接)

内嵌代码和代码块

在博客开头的例子中，我写了一段Java代码。在博客中，我们也经常可以看见示例代码的区域。

而想要实现这个效果，就需要用到内嵌代码和代码块，其代码和展现的效果如下：

``

```  ```

上面一组反单引号是一句代码，下面一组三反单引号是一个代码块

什么，你问我反单引号怎么输入？英文输入法，看到键盘上面的横排小数字键了吗，按最左边这个键：

表格

表格常常是笔记中不可或缺的一部分，因此还是需要掌握它的代码的，以下面这个4*4的表格为例：

上面颜色略深的部分叫做表头（thead），中间的部分是表身（tbody） ，完成这个表格的代码是这样的：

|  |  |  |  |
| --- | --- | --- | --- |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

不难理解，两个“ | ”之间的部分就是表格中的内容，“ | --- | ”就是表头和表身的分界线 。

在后面，我们也可以直接使用HTML来完成表格，其实也是很简单的，你甚至可以设置表格的样式，比如大小、边框等，这里就不展开说了。

公式

还记得上面的代码块是如何插入的吗，数学公式的插入和它是差不多的，不过要多一个math标记：

```math
(你的数学公式)

![](https://i-blog.csdnimg.cn/direct/b5309c73c96c45e19ba99a32003ff985.png)

类似的，再加上一点代码，我们可以得到一个化学公式：

\ce{你的化学公式}

![](https://i-blog.csdnimg.cn/direct/c556405c1b654e498c035665cdaf9871.png)

在使用数学公式和化学公式时，常常会用到很多**符号**。我在下面的表格里列出了几个常用的符号（多的我也不会……）：

   化学/数学公式少量符号 
 字母前数字正常显示字母后数字下标^ 加 任意内容上标（用空格结束上标）^↑（气体）v↓ （沉淀）=生成->动态平衡方程（生成方向右）<-动态平衡方程（生成方向左）
博主高考考理综都多少年前了，真不记得哪些符号了……

#### 其他

最后的三项，流程图、时序图、甘特图，其实也可以用代码来写，但是我个人**不建议**。

我的建议是使用专门绘制这些图的工具，比如Visio等，绘制出相关的图，然后直接用前面所说的**插入图片**的方式插入。

其实，对于上面的公式，我也建议可以使用MATHTAB等专业的书写公式的工具制作完之后，以图片的形式插入，可以减少工作量，也可以让效果更加美观。

### 源代码

关于Md案例讲解的全部源代码都放在这里了，有兴趣的可以自己敲敲看。

加粗文字

斜体文字

++下划线文字++

删除线文字

==荧光标记文字==

标题一

标题二

标题三

标题四

标题五

标题六

引用的文字1
引用的文字2
引用的文字3
引用的文字4

这里就不是引用部分了

• 无序一级1
  • 无序二级1
  • 无序二级2
• 无序一级2

1. 有序一级1
   1. 有序二级1
   2. 有序二级2
2. 有序一级2

• <input disabled="" type="checkbox"> 未完成

• <input checked="" disabled="" type="checkbox"> 已完成

链接替换的文字

我是一句代码

谁不是啊
我还是一段代码呢

E = mc^2

\ce{2H2O2 = 2H2O + O2 ^}

flowchart LR
    Start --> Stop

sequenceDiagram
    participant A as Alice
    participant J as John
    A->>J: Hello John, how are you?
    J->>A: Great!

gantt
    title A Gantt Diagram
    dateFormat  YYYY-MM-DD
    section Section
    A task           :a1, 2014-01-01, 30d
    Another task     :after a1  , 20d
    section Another
    Task in sec      :2014-01-12  , 12d
    another task      : 24d

```

预告和回顾

PS系列的有关博客我暂时还没有写完，同时也已经开始写和HTML有关的博客了。下一期可能先会接着出HTML的第一期博客，因为PS第四期的UI博客内容有点多，暂时写不动了……

还是那句话，博主的初心不变，还是以杂谈的形式分享知识，交流心得，并共同进步。

喜欢我的博客风格的朋友，不妨看看我的SVN系列和PS系列的博客：

项目管理 | SVN（全一期）

UI设计 | PS第一期（当前更新到第三期）

后话

笔者也是一个刚刚接触全栈的小白，对于这些东西也是才会使用不久。关于这篇博客，主要是记录一下自己学习的一些经历，然后把自己领悟到的一些东西总结一下，分享给大家。

文章全篇的操作过程都是笔者亲自操作完成的，一些定义性的文字加入了笔者自己的很多理解在里面，所以仅供参考。如果有说的不对的地方，还请谅解。

【H2O2】