这个工具做什么
Markdown 用少量符号表达结构:井号开头是标题,星号包裹是强调,短横线加空格是列表项,反引号包围是代码。写说明文档、接口备注、发布清单时,直接读源文不如看排版后的效果直观。这个工具把左侧的 Markdown 源文按常见规则解析,在右侧生成对应的标题、段落、列表、引用、代码块与表格,方便在发布前检查层级和格式是否写对。
解析器只在本页实现,不依赖任何外部库。处理顺序是先把文本按行切成块(标题、列表、代码块、表格等),再对块内的文字做行内解析(粗体、斜体、行内代码、删除线)。支持的语法范围写在页面下方的「使用限制与提醒」里,超出范围的写法会按普通文字显示,不会报错,也不会中断整篇渲染。
安全方面的处理是刻意保守的:整段输入始终被当作纯文本,构建页面元素时只用文本节点填充内容。原始 HTML 标签会原样显示成文字,链接不会生成可点击的锚点,图片不会生成图像元素,因此预览过程不会发起任何网络请求,也不会执行脚本。
怎么用
把 Markdown 粘贴到左侧输入框,停止输入约 200 毫秒后右侧自动刷新,不需要点按钮。右侧区域可以独立滚动,长文档不会把页面撑高。底部统计给出字数、行数与字符数,字数按非空白字符计算,行数按换行符切分。
- 「载入示例」填入一份包含标题、任务列表、有序列表、引用、围栏代码块、表格、分隔线、链接与图片写法的示例,可以对照右侧逐项确认解析效果。
- 「清空」同时清除源文与预览,输入框保持焦点,方便继续粘贴下一段。
- 写标题时井号与文字之间要留一个空格;六级以上不支持,超过六个井号会按段落处理。
- 围栏代码块用三个反引号或三个波浪线开始,结束行必须使用同一种符号且长度不短于开始行;开始行后面的单词会作为语言名显示在代码块顶部。
- 任务列表写成短横线加方括号,方括号内是一个空格表示未完成,写 x 或 X 表示已完成。
如果某段写法没有按预期渲染,先检查符号是否成对、符号与文字之间是否有必要的空格。解析器不会自动纠错,缺少闭合符号时会把符号当作普通字符输出,这样比猜测意图更安全,也更容易定位问题。
结果怎么解读
块级结构
标题按层级显示为不同的字号,层级越深字号越小,但都不会生成页面级的主标题,因此预览里的标题不会影响页面本身的文档结构。列表项按源文顺序排列,有序列表保留起始编号;连续的任务项会显示方框,已完成的方框带勾选标记。引用块左侧有一条竖线,内部可以继续包含段落和列表。
表格要求第二行是分隔行,单元格由竖线分开。分隔行里的短横线数量不影响渲染宽度,冒号表示对齐方式,但本工具只做基础展示,不额外设置列对齐。表格外层可以横向滚动,列多时不会挤压页面。分隔线用三个以上的短横线、星号或下划线单独成行表示。
行内格式与占位显示
粗体用两个星号包裹,斜体用一个星号包裹,删除线用两个波浪线包裹,行内代码用反引号包裹。行内代码内部的符号不再参与解析,所以可以在代码里安全地写星号或下划线。强调符号必须成对出现,找不到闭合符号时会原样显示。
链接写成方括号加圆括号的形式,预览里显示为「文字(地址)」的纯文本,不会变成可点击的链接。图片写成感叹号加方括号加圆括号,预览里显示为「[图片:说明] 地址」的占位文字,说明为空时显示「[图片]」。这样处理是有意为之:预览阶段不需要访问目标地址,也不会因为一张外链图片暴露访问者的网络环境。
常见的几种情况
原始 HTML 标签显示成了文字
例如输入一段带尖括号的标签,右侧看到的就是这段标签本身,而不是渲染后的元素。这是预期行为。预览器不解析 HTML,也不做白名单过滤后再插入,而是从源头上不把输入当作标记。这样做的好处是不会因为粘贴了来路不明的内容而在页面里执行脚本;代价是确实需要 HTML 结构时无法在预览里看到效果。
表格没有渲染成表格
最常见的原因是第二行分隔行缺失,或者分隔行里的短横线被写成了中文标点。表格至少要有两行:第一行是表头,第二行由短横线和竖线组成。单元格数量不要求完全一致,缺少的单元格会留空,多出的会被忽略。如果表格出现在列表项后面且没有空行,解析器可能把它当成列表内容的一部分,补一个空行通常就能恢复。
代码块里的符号被当成格式
行内代码需要用反引号包住,多行代码需要用围栏代码块。只在行首缩进四个空格的传统写法不在支持范围内,会被当作普通段落。围栏代码块内部的内容完全按原文显示,星号、井号、竖线都不会触发格式解析,适合放配置文件片段或命令。
列表项里的文字没有换行
同一个列表项内的连续文字会合并成一段。需要在项内换行时,可以在行末留两个空格再换行,或者直接把内容拆成多个列表项。列表与上下段落之间最好留一个空行,否则解析器可能把紧随其后的文字并入最后一项。
使用限制与提醒
单次输入上限为 200,000 字符。超过上限时工具不会渲染半截内容,而是提示超限并保留上一次的预览结果。字符数按 JavaScript 字符串长度计算,中文算 1,emoji 等需要两个编码单元算 2。超长文档建议拆成多个文件分别预览。
语法支持范围是常见子集,不包含嵌套列表、引用内的表格、脚注、定义列表、数学公式、自动链接与 HTML 块。嵌套结构会按最外层解析,内层符号可能作为文字保留。解析器也不做 Markdown 规范的全部边界处理,例如连续强调符号、转义字符的组合、链接地址里的括号,都可能与标准实现有细微差异。
最重要的一点:这里的预览用于检查排版,不能当作最终发布效果。不同平台对 Markdown 的扩展不同,任务列表、表格、删除线的写法在部分系统里可能不被识别;链接和图片在真实页面上会被解析成可点击、可加载的元素,安全和隐私策略也与本页不同。需要发布时,应以目标平台的渲染结果为准。