← 返回首页

Markdown写作技巧与语法

发布:2026-08-31 · 分类:写作工具

核心语法速记

语法效果
# 标题一级标题,##二级,依此类推
**加粗** / *斜体*粗体与斜体
- 列表项无序列表
1. 列表项有序列表
[文字](url)超链接
![alt](图片)图片
> 引用引用块
三反引号代码块(可标语言)

表格的正确姿势

表格是Markdown里最容易写错的部分。表头和内容行之间必须有一行分隔线(---),列数要一致:

| 工具 | 用途 | 免费 |
| --- | --- | --- |
| 格式化 | 数据调试 | 是 |
| 压缩 | 图片优化 | 是 |

单元格内放不了块级元素,需要复杂排版时老老实实上HTML标签,Markdown完全兼容内嵌HTML。

写作组织技巧

文档工程化

写系列文档时,建立统一的命名规范(如 01-install.md02-config.md),配一个README做索引。图片放 images/ 子目录按文档名分文件夹,避免越积越乱。这套习惯迁移到任何写作平台都适用。

相关阅读

Markdown文档里嵌接口示例可以看curl转代码指南,处理文档数据配合JSON格式化更顺手。