最简Markdown教程

最简 Markdown 教程

Markdown 的语法虽然简单,但对于知识管理来说,很多格式语法仍然不是非常必要的。为了降低你的学习压力,这里我们先只介绍一下那些必不可缺的语法。

一、创建小标题

在 Markdown 中,创建小标题是十分简单的,只需要在一行的开头打下一个或多个 # 号,后面敲下一个空格后,再跟上具体的小标题名称即可。比如:

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

Markdown 最多支持六级小标题,因此不要无脑打太多 # 号。

二、划分段落

在标准的 Markdown 语法中,段落是根据空行进行划分的。也就是说,如果想要结束一个段落并进入一个新段落,则需要在段落后按下两次回车。比如:

这是一个段落,我现在想要结束这个段落。我准备按下两次回车。

新段落开始了

对于习惯于 Word 的朋友来说,这个操作可能会比较反直觉。毕竟在 Word 等软件中,按一次回车即可产生新段落。但需要注意的是,在标准的 Markdown 语法中,按下一次回车只会被软件识别为换行,而不会产生新段落。因此,为了保证我们的语法能被广大 Markdown 编辑器以及笔记软件兼容,请使用标准的语法——即在标题与段落之间、段落与段落之间、各种元素之间,保持空一行。

三、加粗、倾斜

在 Markdown 中,加粗倾斜都是通过用特殊符号包括所需标注的字符实现的。

这是**加粗**字体	

这是*倾斜*字体	

需要注意的是,在知识管理中,这种标记其实作用不是很大——因为我们需要在乎的是记录的内容以及如何管理记录的内容。所以不要花费太多时间在如何给字词作出不同的标注。

四、有序列表与无序列表

在 Markdown 中,创建有序列表只需要以数字开头,并紧跟一个英文句点后加空格。数字不必按顺序排列,但应当以数字 1 起始。

以下是有序列表的例子:

1. 第一项
2. 第二项
3. 第三项

而对于无需列表来说,则以破折号 - 或星号 * 或加号 + 开头,并紧跟一个空格。

以下是无序列表的例子:

- 第一项
- 第二项
- 第三项

五、记录代码

对于计算机相关的知识来说,用合适的格式记录代码是非常重要的。毕竟我们也不想让代码和普通文本混淆。

在 Markdown 中,我们可以通过行内代码和代码块两种语法来记录代码。

所谓行内代码是指在一行普通文本中插入 部分代码,就像这里的“部分代码”四个字一样。行内代码只需要使用反引号 (`) 包裹即可。比如:

这是一个`行内代码`的例子

如果想写多行代码,则需要使用代码块。代码块有两种创建方法,一种是将代码块的每一行缩进四个空格,另一种则是使用三个反引号(```)或三个波浪号(~~~)。

这是使用缩进的代码块:

    <html>
      <head>
      </head>
    </html>

这是使用反引号的代码块

```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```
这是使用波浪号的代码块

~~~
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
~~~

七、插入链接

有时候,我们需要在笔记正文中插入链接。这个链接可能是网络上的链接,也可能是指向我们本地另一篇笔记或文件的链接。

Markdown 中链接的语法是 [超链接显示名](超链接地址)。比如:

这是一个链接 [Markdown语法](https://markdown.com.cn)。

这是一个本地链接[0. 为什么要学习 Markdown](0.%20为什么要学习%20Markdown.md)

对于 Obsidian 等笔记软件来说,插入链接语法则被更简单的 [[]] 替代。

八、插入图片

Markdown 中插入图片的语法和插入链接的语法非常相似,因为它们本质上都是插入某些东西。但是,由于插入的图片需要显示,所以多加了一个 ! 在前面。

这是插入图片的语法

![这是图片](/assets/img/philly-magic-garden.jpg "Magic Gardens")

和插入链接一样,图片链接可以是本地的也可以是网络上的。

小结

到这里,你已经学会了基本的 Markdown 基本用法了。接下来你就可以开始学习具体的个人知识管理软件使用了。

接下来:个人知识管理软件 Obsidian新手指南



反馈交流

其他渠道

版权声明