什么是Markdown 预览器？
Markdown是一种轻量级格式化语法，广泛用于README、博客文章、聊天消息、文档，以及无数其他需要简单、可读格式而无需编写原始HTML的场景。由于Markdown是纯文本，因此可以在任何地方轻松编写——但也很容易在语法上出小差错而发布前未察觉。
这款预览器在您输入Markdown的同时进行实时渲染，源代码与预览并排显示，让您能立即发现格式错误——比如#后面缺少空格、未闭合的代码块、或者列表未能与上方段落正确分隔——在提交README、发布文章或发送格式化消息之前及时修正。
何时使用此计算器
- 编写GitHub或GitLab README并想在提交前验证格式
- 为博客平台、文档网站或Wiki起草Markdown帖子
- 在发送前检查Markdown电子邮件或聊天消息是否正确渲染
- 通过尝试不同格式并即时查看结果来学习Markdown语法
- 将简短的Markdown片段转换为HTML以粘贴到CMS或电子邮件模板中
- 调试某些格式未按预期渲染的Markdown文档
步骤:
- 在左侧面板中输入或粘贴你的 Markdown。
- 观察右侧渲染后的 HTML 预览即时更新。
- 调整语法，直到预览效果符合你的预期。
- 对结果满意后，复制你最终完成的 Markdown 源码。
公式
使用场景
- 在提交前预览GitHub或GitLab的README
- 为Slack、Discord或其他支持Markdown的聊天应用草拟格式化消息
- 在发布前检查博客文章或文档的格式
- 通过实验并即时查看结果来学习 Markdown 语法
- 快速将一小段 Markdown 转换为 HTML 以便粘贴到其他地方
主要优势
- 即时查看你的 Markdown 渲染效果，与源码并排显示
- 在发布到任何地方之前发现语法错误
- 完全离线运行在你的浏览器中——不上传任何内容
- 免费、无需注册，对常规使用没有文件大小限制
专业提示
- 在列表和代码块的前后都添加空行，以在不同的 Markdown 解析器中获得最可靠的渲染效果
- 使用双星号表示加粗，单星号（或下划线）表示斜体，以避免歧义
- 先在本工具中预览，然后再检查目标平台（GitHub、Slack 等），因为有些平台支持表格等额外语法
- 保持标题层级连续（不要从 # 直接跳到 ###），以获得更好的文档结构和可访问性
需要避免的常见错误
- 忘记在段落和后续列表之间留出必要的空行
- 标题中 # 符号后缺少空格，导致标题无法正确渲染
- 留下未闭合的代码围栏（```），导致文档其余部分被当作代码处理
- 使用单个星号表示加粗而不是双星号，结果得到的是斜体而不是加粗
关键术语解释
- CommonMark：一种标准化的 Markdown 语法规范，旨在减少不一致性
- GFM：GitHub 风味 Markdown，一种支持表格和任务列表的扩展方言
- 代码围栏（Code fence）：由三个反引号（```）分隔的代码块，用于格式化多行代码
- 行内格式（Inline formatting）：在单行内应用的格式，如 *斜体* 或 `代码`，与块级元素相对
相关概念
示例
输入 "## 你好
这是**加粗**，这是*斜体*。" 会渲染为一个二级标题，后面跟着一个包含加粗和斜体文本的段落。
解读您的结果
左侧面板显示原始的 Markdown 源文本，右侧面板会实时将其渲染为格式化后的 HTML。每次按键都会立即更新预览，因此你可以马上看到每个语法元素的效果。
常见的渲染问题通常与间距有关。大多数渲染器都要求在段落和其后的列表之间留一个空行。标题需要在 # 符号后加一个空格。代码围栏 (```) 需要单独占一行才能触发代码块渲染。
预览会非常接近你的 Markdown 在大多数平台（GitHub、Slack、Discord 等）上的显示效果，但每个平台都有自己的渲染器，存在细微差异。对于超出基本格式的任何内容，请务必在目标平台上进行最终检查。