Overview
先看明白,再动手。
Markdown 预览器在本地把 Markdown 源文实时渲染为可读版面,覆盖标题、列表、代码块、引用等常见语法,方便写 README、说明文档或发布前校对。它是预览而非完整 CMS:扩展语法(任务列表、脚注、数学公式、Mermaid 等)是否支持以客户端实现为准,不同渲染器细节也会有差异。
Audience
适用人群
写技术文档、更新日志、笔记的开发者与内容作者。免费工具;需要协同编辑与权限体系时请用专门文档平台。
Scenarios
什么时候用它
写 README 时左右对照,确认标题层级与列表缩进
检查代码块语言标记与换行在渲染后是否可读
发布前快速扫一眼引用、加粗、链接是否写对
从别处粘贴 Markdown,先预览再拷进仓库或博客
Highlights
能力亮点
Step by step
使用步骤
打开预览器
进入「开发工具」→「Markdown 预览器」。可粘贴文本或打开 .md 文件(若支持)。
编写或粘贴源文
按 Markdown 基本语法组织标题与段落。先保证结构清晰,再堆装饰性语法。
对照预览修正
看层级是否跳级、列表是否断掉、代码块是否闭合。链接与图片地址用真实可访问路径试一次。
处理扩展语法
若预览未渲染表格/任务列表/公式,说明当前渲染子集不包含;改写为更通用写法或换目标平台预览。
导出或复制
把定稿源文保存回 .md 或复制到发布位置。需要 HTML 时以客户端是否提供导出为准。
Notes
使用前留意
- 同一份 Markdown 在 GitHub、Notion、静态站点生成器上的渲染可能略有差别。
- 不要在 Markdown 里嵌入不可信 HTML(若渲染器允许裸 HTML,有 XSS 风险)。
- 超大文档可能预览卡顿,可分段编辑。
- 图片需本地路径或可访问 URL,断链在预览里就会表现为裂图。
FAQ
常见问题
为什么我的表格没有出来?
基础 CommonMark 不含表格;许多实现用 GFM 表格扩展。若当前预览器未启用该扩展,表格会当普通文本显示。
能当完整编辑器替代 Word 吗?
不能。它擅长结构化纯文本与代码说明,不擅长复杂排版、修订轨迹与邮件合并。
预览和 GitHub 显示不一致?
扩展语法、换行策略、emoji、锚点生成规则都可能不同。以目标托管平台的预览为最终验收。
支持数学公式或流程图吗?
取决于客户端是否集成对应插件。未支持时请用目标站点的专用语法,或导出后在支持的环境渲染。