Markdown 写作速查手册

发表于 分类于 本文字数： 370 阅读时长 ≈ 1 分钟
写博客最常用的 Markdown 语法合集，含标题、列表、表格、代码块、引用和图片，可直接当模板抄。

Hexo 的文章正文就是 Markdown，这篇把常用的语法整理成速查表，忘了就回来翻一下。

标题

用 # 表示层级，一到六级：

1
2
3
# 一级标题
## 二级标题
### 三级标题

强调

写法 效果
**加粗** 加粗
*斜体* 斜体
~~删除线~~ 删除线
`行内代码` 行内代码

列表

无序列表用 - 或 *：

1
2
3
- 第一项
- 第二项
  - 嵌套项

有序列表用数字加点：

1
2
1. 第一步
2. 第二步

链接与图片

1
2
[链接文字](https://hexo.io/)
![图片描述](/images/photo.jpg)

图片放在 source/images/ 目录下，引用时写 /images/文件名 即可。

引用

1
2
> 这里是引用内容。
> 可以写多行。

效果：

写作不是记录想法，而是产生想法。

代码块

用三个反引号包裹，并在开头标注语言，Hexo 会做语法高亮：

1
2
3
4
```javascript
const site = "拾光笔记";
console.log(`欢迎来到 ${site}`);
```

表格

1
2
3
| 列一 | 列二 | 列三 |
| --- | :---: | ---: |
| 左对齐 | 居中 | 右对齐 |

分隔线

1
---

在 Hexo 里写作的小技巧

  • 文章开头必须有 Front Matter，title、date 是最基本的字段；
  • <!-- more --> 可以手动指定首页摘要的截断位置；
  • 文件名尽量用英文或拼音，避免部署后出现 URL 编码问题；
  • 需要频繁插图的文章，可以开启 post_asset_folder: true，让每篇文章拥有独立的资源目录。

以上就是全部常用语法。掌握这些，写一篇排版清爽的技术文章已经足够了。