Hexo建站指南(二):Markdown语法与编辑器
前言
现在,我们已经在本地安装并初步配置好了Hexo。接下来,我们就要进行内容的创作了。Hexo与Word这种富文本编辑器不同,它使用Markdown语法,让整个流程变得更加简单高效。本篇,我将带读者选择一个适合自己的Markdown文本编辑器,并学习Markdown语法。
选择Markdown编辑器
目前来说,各种Markdown编辑器层出不穷。
Markdown编辑器最好具有以下功能:
- 支持自动补全,即能够自动补充标记符号,例如链接。
- 支持查找替换,便于编辑。
- 支持标题跳转和自动大纲生成。
- 支持代码语法高亮。
- 支持自定义外观,例如配色、字体和字号。
满足以上要求的基本就算是比较好用的Markdown编辑器了。当然,如果你有什么特殊需求的话,别忘了也考虑进去。
我个人用过的编辑器有以下几款,仅供参考:
一款之前免费,现在收费的Markdown编辑器。最大特点就是简洁好用。支持.md/.html/.pdf等格式导出。三个设备授权需要15$(约110元人民币左右)。
一款免费的笔记软件,支持多种编辑语法,有社区插件,功能非常强大,全客户端可用。
VS Code,这个不用介绍了吧,最好用的IDE之一,拥有丰富的插件,Markdown编辑插件就是其中之一。这也是本人在主要使用的编辑器。
不要拘泥于以上推荐的软件,有什么需求可以自行寻找。没有最好用的编辑器,适合自己的就是最好的。
Markdown语法
这里介绍几个常用的简单的Markdown语法。所有标记符号均为英语半角符号。部分标记符号若不起作用,可以尝试在标记符号后添加一个空格。出于排版考虑,这里不展示每种语法的效果,你可以在自己挑选的编辑器中尝试。
标题
使用 # 来标记一个标题。标题等级取决于 # 的数量。
1 | # 这是一个一级标题 |
分行与段落
使用换行来分行。每个段落以空行分割。
1 | 这是第一段第一行。 |
在绝大部分Markdown解析器中,分行后的两行内容,即使末尾存在空位,下一行的内容也会另起一行显示。
字体
粗体
粗体使用首尾各两个*号进行标记(即**)。文首的两个星号标记着粗体文本的起始位置,文末的两个星号标记着粗体文本的结束位置。**会向前寻找最近的一个未配对的双星号配对标记粗体文本。如果找不到,则形成一个单独的未配对的双星号,在此之后的所有文本均为粗体,直到添加一个双星号。
1 | **这是一段粗体文本。** |
斜体
斜体使用首尾各一个*号进行标记。配对方式与粗体相同,不再赘述。
1 | *这是一段斜体文本。* |
引用和代码
引用、引用块和嵌套引用
引用使用右尖括号>进行标记。
1 | >这是一行引用 |
如果需要多行引用,在需要引用的行的行首添加右尖括号即可。相邻的引用行会自动合成一个整体,称为引用块。可以进行分行和分段操作。
1 | >这是第一段引用的第一行。 |
引用或引用块均可嵌套。嵌套层数没有限制。
1 | >最外层嵌套 |
代码和代码块
代码使用首尾各一个反引号`进行标记。配对方式与粗体、斜体相同。
1 | `这是一行代码。` |
多行代码在首行代码的上一行和最后一行代码的下一行使用三个反引号(即```)进行标记。
1 | \``` |
代码或代码块不能嵌套。
列表
有序列表
使用阿拉伯数字和点号.标记一个有序列表。有序列表必须从数字1开始,但可以不连续。
1 | 1. 列表第一项。 |
有序列表不可嵌套。
无序列表
使用连字符-标记一个无序列表。
1 | - 无序列表。 |
无序列表不可嵌套。
表格
Markdown的表格十分形象。使用管道符号|作为竖线,使用连字符-作为横线。表格首尾行都不需要横线封口,但左右两侧需要竖线。横线不可穿过竖线。表头的下一行需要最少三个连字符进行分割。
1 | |表头1|表头2| |
部分编辑器可能不支持表格语法。
分割线
使用单独成行的至少三个连字符进行分割。
1 | 分割内容的上半部分。 |
外部链接和图片
外部链接
使用以下示例中的语法引用外部链接。
1 | [链接显示的内容](https://link.example.com) |
图片
使用以下示例中的语法引用图片。
1 |  |
注意:图片文件路径可以使用相对路径或绝对路径。绝对路径(例如,在Windows当中以盘符开头的路径,在Linux中以 /(根目录)开头的路径)可能会因为文件的迁移(例如,push到GitHub上)而失效。如果使用相对路径,在使用编辑器编辑本地图片时,请确保图片文件与所编辑的Markdown文章文件的相对位置不变,否则图片不会显示。
图片还可以附上外部链接,只需要在上述结构后添加一对圆括号,在其中写入外部链接即可。
1 | (https://linkforpicture.example.com) |
高级内容
Markdown可以与HTML混编。这也就意味着,你可以在内容中插入HTML代码。或者利用插件等方式使用其他的标记语言。
完整的Markdown语法可以查阅Markdown中文官方教程。
如果你感兴趣,也可以初步了解一些简单的HTML语法。
结束语
Markdown编辑器没有最好的,只有适合自己的。Markdown语法非常简单,简单写点东西练习一下就能掌握。甚至于,你可以使用编辑器的工具栏协助,这让Markdown上手难度又低了许多。