跳到主要内容
吴隆平
所有文章

写文章用得上的 Markdown 速查

加粗、列表、链接、图片、引用、代码 —— 写博客需要的格式,一页看完。

写文章用的是 Markdown:一种用符号代替排版按钮的写法。常用的就这几个,看一遍就会了。

这篇留着当参考,也可以直接删掉。

标题

## 二级标题
### 三级标题

文章正文里不要用一级标题(单个 #),因为页面顶部那个大标题已经是一级了。

强调

**加粗**,*斜体*,~~删除线~~

加粗,斜体,删除线

列表

- 第一项
- 第二项
  - 缩进两个空格就是子项

1. 有序列表
2. 第二条
  • 第一项
  • 第二项
    • 缩进两个空格就是子项

链接和图片

[显示的文字](https://example.com)

![图片的说明文字](../../../assets/your-image.jpg)

图片要先放进 src/assets/ 文件夹,再按上面的写法引用。方括号里的说明文字很重要:看不见图片的人靠它理解内容,搜索引擎也看它。

引用

> 引用的内容放在大于号后面。

引用的内容放在大于号后面。

代码

行内代码用一对反引号包起来:像这样。

整段代码用三个反引号包起来,第一行可以写语言名字(会自动上色):

def hello(name):
    print(f"你好,{name}")

分隔线和表格

---

| 列一 | 列二 |
| --- | --- |
| 内容 | 内容 |
列一 列二
内容 内容

两个容易踩的坑

空行很重要。 两段文字之间一定要空一行,否则会被挤成一段。

日期格式固定。 文章顶部的 pubDate 要写成 2026-11-20 这种格式。写成 2026/11/20 或者 11月20日 会报错。