Markdown 解析器

解析 Markdown 并预览渲染后的 HTML,支持 GFM 语法。所有处理在浏览器中完成。

实时预览 GFM 支持 客户端处理

HTML预览将在此显示...

如何使用 Markdown 解析器

1

输入 Markdown

在输入框中输入或粘贴 Markdown 内容。

2

预览

工具将实时渲染 HTML 预览。

3

复制

复制渲染后的 HTML 源码。

什么是 Markdown?

Markdown 是一种轻量级标记语言,使用简单的纯文本语法创建格式化文档。广泛用于 README 文件、文档、博客和论坛。

支持的语法

标题

使用 # 语法的H1到H6

文本格式

粗体、斜体、删除线、行内代码

列表和表格

有序、无序、任务列表和GFM表格

代码块

带语法高亮的围栏代码块

常见问题

支持哪些 GFM 扩展?

支持表格、任务列表、删除线、自动链接、代码块语法高亮等 GFM 扩展。

支持数学公式吗?

目前不支持 LaTeX 数学公式渲染。

HTML 预览可以自定义样式吗?

预览使用工具内置的默认样式。复制的 HTML 源码可以在自己的页面中自定义。

Markdown、CommonMark 和 GFM 有什么区别?

最初的 Markdown(2004)对许多边界情况没有明确定义,导致各实现之间出现分歧。CommonMark 是解决这些问题的严谨规范;GFM(GitHub Flavored Markdown)则在 CommonMark 基础上增加了扩展:表格、任务列表、删除线、自动链接,以及 disallowed-raw-HTML 过滤器。本工具渲染 GFM,与您在 GitHub 上看到的效果一致。

如何编写代码块和行内代码?

行内代码用单个反引号包裹。围栏代码块使用三个反引号,并在开头一行标注语言标签以启用语法高亮,例如 ```python,也可以将每一行缩进四个空格(较旧的语法,在列表内容易出现问题)。当代码本身包含反引号时,也可以使用三个波浪号作为围栏。

可以在 Markdown 中嵌入原始 HTML 吗?

可以——行内 HTML 标签会直接传递到输出中。GFM 的 disallowed-raw-HTML 扩展在过滤器启用时仅移除少数危险标签(script、style、iframe 等)。两点需要注意:块级 HTML 包裹的内容内部将停止解析 Markdown 语法(空行很关键),并且任何用户提交的 Markdown 除了标签过滤之外,还必须进行 XSS 清理。

GFM 中的表格是如何工作的?

表格由竖线分隔的行组成,表头下方是一行连字符作为分隔线。冒号用于设置对齐方式:左侧的冒号加连字符表示左对齐(默认),两端都有冒号表示居中,连字符加冒号表示右对齐。单元格不能包含块级元素;字面竖线需转义为 \|;每行外侧的竖线是可选的。更复杂的布局需要原始 HTML 或文档引擎。

为什么我的列表或嵌套项渲染不正确?

常见原因包括:缩进不一致(嵌套项通常需要与父项内容的第一个字符对齐)、段落与列表之间缺少空行,或制表符与空格混用。CommonMark 对所有这些情况都有明确规定。将制表符转换为空格,并在列表前后添加空行,可以解决绝大多数嵌套问题。

{-- * External Resources Component(#18 Phase 3b 内容佐证工程) * 工具页「权威引用」区块:RFC / W3C / WHATWG / ECMA / IANA / 官方规范站 / Wikipedia。 * * - 接受 :slug 属性 → 经 config/tool-sources.php 家族矩阵渲染该工具的权威引用 * - slug 未命中映射时不渲染(无权威来源的工具静默跳过) * - 链接 title 保持英文(引用源专名);description 经 * common.resources.descriptions.{key} 本地化,lang 未命中回退英文(线上不裸奔) * - 链接保持 dofollow(rel="noopener noreferrer") * * @param string|null $slug --}}