Markdown 编辑器
在你的设备上运行,不会发送任何内容。一切都在您自己的设备上完成。您输入的任何内容都不会被发送到任何地方。
Markdown
预览
渲染后的预览将显示在此处
在浏览器本地实时预览地撰写 Markdown,然后导出干净的 HTML 或原始 Markdown 文件。
此编辑器会在您输入时,完全在浏览器本地实时将 Markdown 转换为 HTML,并支持人们日常真正会用到的语法:标题、粗体和斜体文本、链接、图片、列表、引用、行内代码和代码块。在应用任何格式之前,您输入的所有内容都会先进行 HTML 转义,因此粘贴的 HTML 或脚本标签会以纯可见文本的形式显示,而不会被执行——您写的任何内容都不会被上传到任何地方。
常见问题
这是完整的 CommonMark 规范吗?
不是——这里涵盖的是人们最常用的语法(标题、强调、链接、图片、列表、引用、代码),而不是包含嵌套列表、表格或脚注等所有边界情况的完整 CommonMark 规范。对于日常笔记、README 文件和文档来说,这个核心子集已经覆盖了现实中绝大多数的 Markdown 用法。
从我不完全信任的来源粘贴 Markdown 安全吗?
安全。在应用任何 Markdown 格式之前,您输入或粘贴的每一个字符都会先进行 HTML 转义,链接或图片的 URL 在使用前也会与安全协议白名单(http、https、mailto 以及相对路径)进行比对——粘贴的 javascript: 链接或嵌入的 <script> 标签会以无害的可见文本形式显示,而不会被执行。
HTML 下载和 Markdown 下载有什么区别?
Markdown 下载会将您输入的内容原样保存为 .md 文件,方便日后继续编辑或提交到代码仓库。HTML 下载则会将渲染后的输出保存为独立的 .html 文件,可以直接粘贴到 CMS、电子邮件或其他任何需要成品 HTML 而非 Markdown 源码的地方。
为什么预览中我的换行消失了?
解析器遵循标准的 Markdown 段落规则:没有以空行分隔的行会被合并成一个段落,每个换行都会被折叠为一个空格。如果你想要新的段落,请在文本块之间留一个空行 - 只按一次 Enter 不会在渲染输出中产生可见的换行。
代码块是否支持像 ```js 这样的语言的语法高亮?
目前还不支持 - 你在开头的三个反引号后写的语言名称,仅用于标记代码块的起始位置,会被丢弃,既不会显示也不会被着色。围栏内的所有内容都会被转义,并以纯等宽文本形式呈现,因此你的代码会与输入内容完全一致,只是没有语法着色。
支持表格吗?
目前还不支持——此解析器专注于人们最常用的语法,而竖线分隔的表格不在这个范围内。用 Markdown 语法写的表格会被渲染成普通段落文本,而不是真正的表格,所以如果导出的结果中需要表格,目前需要直接用 HTML 编写。
支持嵌套列表吗?
不支持——无论前导空格多少,每个列表项都会被当作平级处理,因此缩进某一行来创建子列表不会生成嵌套列表,而是会被渲染成另一个顶层列表项。如果你需要层级结构,最接近的变通方法是用标题或在代码块内手动缩进来表现。
使用 * 还是 _ 来表示粗体和斜体有区别吗?
没有区别——两者的处理方式相同。**粗体** 和 __粗体__ 都会生成粗体文本,*斜体* 和 _斜体_ 都会生成斜体文本。工具栏上的 B 和 I 按钮总是插入星号形式,但自己输入下划线形式的效果完全相同。
可以用 ~~这样~~ 给文字加删除线吗?
目前不行——删除线不在此解析器识别的语法范围内,所以 ~~文字~~ 会按字面渲染成普通文字两侧加上波浪号,而不是加删除线的文字。这是核心 Markdown 之外比较常见、但此工具尚未支持的扩展语法之一。
有哪些不同的方式可以写出水平分割线?
在单独一行上写三个或更多的连字符、星号或下划线——---、*** 或 ___——都会渲染成水平分割线。工具栏上的 ― 按钮总是插入连字符形式,但如果你自己输入,三种形式的效果完全相同。
引用块可以跨越多个段落吗?
每一段连续的 > 行都会被渲染成引用块内的一个段落,换行会像普通段落一样被折叠为空格。在同一个引用内留一行空的引用行来开始第二个段落是不支持的——这样做反而会结束该引用块。
我可以从 Word 或 Google 文档粘贴带格式的文本吗?
你可以粘贴到编辑器中,但只会保留纯文本——浏览器在粘贴到纯文本框时会去除富格式(粗体、标题、链接),所以文字会保留下来,但格式不会自动变成 Markdown 语法。你需要自己重新应用标题、粗体和链接,这正是编辑器上方工具栏按钮的作用所在。
编辑器上方的按钮有什么作用?
每个按钮都会在光标处插入相应的 Markdown 语法,或者将其包裹在你选中的文本外——选中一个词后点击 B,它就会变成 **词**;在空行上点击 H2,它就会变成标题。它们是此解析器所理解的确切语法的快捷方式,而不是一个独立的格式系统。
粘贴的文本量有限制吗?
没有硬性限制,但整个文档会在你每次按键时都从头重新解析,而且完全在浏览器的主线程中进行。对于笔记和文章来说这是即时完成的,但非常大的文档(数万行)在输入时可能会开始感觉有些卡顿,因为没有增量或后台解析。
对于阿拉伯语或波斯语这类从右到左书写的语言,效果也一样吗?
是的——对于这些语言,页面布局会切换为从右到左,渲染出的预览也会遵循同样的方向,使标题、列表和段落读起来自然流畅。Markdown 语法本身(#、*、> 等)无论语言如何都保持完全相同。
面向开发者:在 URL 中附加 `q` 参数打开此页面——例如 gizke.com/markdown?q=# Hello world——该值会自动预填。大多数访问者不需要这个功能;它是为了能直接链接到一个可用的示例。