最简 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新手指南
讨论
若阁下有独到的见解或新颖的想法,诚邀您在文章下方留言,与大家共同探讨。
反馈交流
其他渠道
版权声明
版权声明:所有 PKMer 文章如果需要转载,请附上原文出处链接。