工具指南Markdown写作工具文档博客工具
Markdown 怎么预览？标题、列表、表格、代码块和链接检查指南
Markdown 写完后要检查标题层级、列表缩进、表格、代码块、链接和图片。这里整理常见语法和预览方法。
打开配套工具 →Markdown 适合写文档、博客、README、产品说明和技术笔记。它轻量，但不同平台渲染细节略有差异，写完最好预览一遍。
你可以用 Markdown 预览工具 查看渲染效果。
常见语法
markdown已剪下 ✓
# 一级标题
## 二级标题
- 列表项
- 列表项
[链接文字](https://example.com)标题层级要连续，不要为了字体大小乱用标题。
表格容易错位
Markdown 表格要求竖线和分隔行。复杂表格建议先用 Markdown 表格生成器 生成，再复制进文档。
代码块要写语言
代码块建议写语言名：
markdown已剪下 ✓
```js
console.log("hello")
这样很多平台会启用语法高亮。
## 发布前检查
1. 标题层级是否清楚。
2. 链接是否可打开。
3. 图片路径是否正确。
4. 表格是否对齐。
5. 代码块是否闭合。
6. 列表缩进是否正确。
## 不同平台渲染会有差异
GitHub、Notion、博客系统、静态站生成器对 Markdown 扩展支持不完全一样。任务列表、脚注、表格、HTML 标签可能在某个平台可用，换到另一个平台就不显示。
重要文档最好在最终发布平台再预览一次，不要只看本地工具效果。
## 图片路径最容易漏
Markdown 里的图片路径可能是相对路径，也可能是绝对 URL。文章迁移目录后，相对路径很容易失效。
发布前可以把图片路径逐个点开，确认部署后也能访问。尤其是 README 和博客文章，图片裂了会明显影响阅读信任。
## 总结
Markdown 写作高效，但发布前一定要预览。尤其是表格、代码块和图片路径，肉眼看源码很容易漏。
你可以用 [Markdown 预览工具](https://flooc.com/tools/markdown) 检查效果，再用表格生成器处理复杂表格。