Markdown 写作完全指南
掌握 Markdown 常用语法,写出结构清晰、阅读体验良好的文章。
Morroa2026年9月10日1 分钟更新于 2026年9月12日
Markdown 的初衷,是让你专注于内容,而不是排版。下面这份指南覆盖了博客中最常用的语法。
标题与段落
使用 # 表示标题层级。正文段落之间保留一个空行。
## 二级标题
这是一个普通段落。
### 三级标题
这是另一个段落。
列表
无序列表适合罗列要点,有序列表适合描述步骤。
- 第一项
- 第二项
- 嵌套项
- 第三项
- 第一步
- 第二步
- 第三步
任务列表
- 完成初稿
- 补充代码示例
- 发布文章
代码块
指定语言可以获得语法高亮:
export function hello(name: string) {
return `Hello, ${name}!`;
}
行内代码使用反引号,例如 process.env.NODE_ENV。
表格
| 功能 | 是否支持 |
|---|---|
| 表格 | 是 |
| 代码高亮 | 是 |
| 任务列表 | 是 |
引用与链接
好的工具应该让创作更简单,而不是增加负担。
链接写作 [文字](https://example.com),图片写作 。
分隔线
使用三个或更多短横线可以创建分隔线:
现在,你已经可以开始写作了。
评论
评论功能默认关闭。你可以在部署时配置 Giscus 环境变量:
NEXT_PUBLIC_GISCUS_REPO等参数后启用。文章 slug:markdown-guide
Related