返回博客
3 分钟阅读
MarkdownToImage
常见 Markdown 错误：复现问题、修正语法、检查导出
用同一份检查表的错误输入、修正代码和导出图片，复现标题、任务列表与链接的常见问题。先排查空格和括号，再判断缩进、代码围栏与渲染器扩展，最后检查真正要分享的文件，同时保留可修改的原稿和可点击的操作入口。
Markdown 写错后往往也能渲染，只是结构与预期不同。打开 Markdown 转换器，一边预览一边缩小问题范围。先修复最小的错误片段，再把改动应用到全文。
把下面这个故意写错的检查表粘贴进编辑器。标题标记后缺少空格，列表标记与复选框黏在一起，链接地址也没有放进圆括号。
#Export check
**Status:** Ready for review
-[x] Heading checked
-[x] List spacing checked
-[ ] Final export inspected
[Open the converter]https://markdowntoimage.com/converter
观察本应出现标题或列表的位置是否还显示原始符号。切换主题不会修复这些语法标记。这是演示内容，可以随意修改，不涉及真实发布清单。
- 在标题标记后加空格：把
#Export改为# Export，首行才能按标题解析。 - 分开列表标记与复选框：把
-[x]改为- [x]，复选框与文字之间也要有空格。任务列表属于 GFM 扩展，渲染器需要支持它。 - 用圆括号包住地址，写成
[label](URL)。方括号里是显示文字，圆括号里是目标地址。链接是否能打开，应在渲染文档中检查，不能只看图片里有没有变色。
下面是完整的修正输入和导出效果：
# Export check
**Status:** Ready for review
- [x] Heading checked
- [x] List spacing checked
- [ ] Final export inspected
[Open the converter](https://markdowntoimage.com/converter)
现在标题、状态和任务项有了清楚的层次。最后一项故意保持未勾选，因为预览整齐不等于已经检查过导出文件。
一个编辑器支持的扩展，另一个未必支持。核心语法可查 CommonMark 规范，表格、任务列表等扩展可查 GFM 规范。保留足够小的出错片段，便于在不同渲染器之间对照。
嵌套列表跑出父项时，检查它的缩进，不要在全文随意补空格。普通文字突然变成代码时，往前找有没有没闭合的围栏。需要原样显示标点时，使用行内代码或合适的转义，不要直接删掉有意义的字符。
预览符合预期后再导出。打开下载的图片，逐项读标题、复选框文字和最后一行。操作链接也要放在图片旁边的正文里：图片是像素，不会保留 Markdown 链接的可点击能力。保留原稿，后续修正时就不用重做整张图。
修正并导出你的检查表。基础语法可继续看 Markdown 实用速查指南；围栏和高亮问题则参阅代码块教程。