关于此工具
Markdown 是一种轻量级标记语言,由 John Gruber 于 2004 年创建,如今已成为 GitHub 开发者文档(README.md)、技术博客写作、Notion 笔记以及 AI 对话排版的事实标准。Markdown 允许创作者使用简易的纯文本符号快速排版出标题、代码块、表格、引用与超链接。本工具提供纯前端实时双栏对照预览,支持 GitHub 风格规范(GFM)、数学公式与暗黑代码高亮,并支持一键复制洁净 HTML。
如何使用本工具(操作步骤)
输入或粘贴 Markdown 原文
在左侧编辑窗口中输入 Markdown 文本,支持拖拽本地 `.md` 文件直接导入内容。
实时查验右侧渲染效果
右侧即时同步渲染出排版美观的富文本,支持 GFM 数据表格、任务清单复选框、引用块以及代码语法高亮。
导出或一键复制 HTML
排版满意后,可一键复制渲染后的 HTML 源码贴入微信公众号、知乎或独立博客,也可直接复制纯文本。
支持 GitHub Flavored Markdown (GFM)
原生支持删除线(~~text~~)、排版表格(|---|)、任务待办清单(- [x])以及自动 URL 链接识别,排版效果与 GitHub 完全对齐。
毫秒级同步联动与滚动跟随
基于高效优化的虚拟 DOM 解析流水线,左侧击键输入右侧毫无肉眼延迟,长文滚动时双栏自动保持平滑对齐。
纯本地离线解析,文章草稿绝不上传
所有 AST 语法树解析与样式注入均在本地浏览器线程中运算,未发布的自媒体长文、学术草稿与技术专利绝无泄密风险。
Markdown 优雅排版与技术文档避坑要点
- •中英文混排务必加空格:在中文汉字与半角英文单词、数字之间手动添加一个空格(如 `学习 React 19 新特性` 而不是 `学习React19新特性`),这是技术排版专业度的分水岭。
- •代码块必须声明语言标识符:在三个反引号后明确标记代码语言(如 ` ```typescript `、` ```python `、` ```sql `),不仅能触发精美的高亮着色,还能协助阅读者快速理解语法环境。
- •换行符的两种不同行为:标准 CommonMark 规范中,单次回车换行只会被视为空格;如果想要硬换行,必须在行末连续敲入两个空格(` `)后回车,或者在解析器中开启 `breaks: true` 选项。
代码与转换对比示例
常见 GFM Markdown 核心语法速查对照
# 一级标题
**加粗文本** 与 *斜体*,还有 ~~删除线~~
| 工具名称 | 类别 | 状态 |
| :--- | :--- | :---: |
| JSON格式化 | 开发 | ✅ |
- [x] 完成 SEO 优化
- [ ] 上线新工具<h1>一级标题</h1>
<p><strong>加粗文本</strong> 与 <em>斜体</em>,还有 <del>删除线</del></p>
<table>...表格数据分列居中对齐...</table>
<ul class="task-list">
<li><input type="checkbox" checked> 完成 SEO 优化</li>
<li><input type="checkbox"> 上线新工具</li>
</ul>* 冒号位置(`:---` 左对齐、`:---:` 居中、`---:` 右对齐)决定表格各列排版走向。
JavaScript 常用 Markdown 解析代码范式
import { marked } from 'marked';
// 开启 GFM 表格与换行换段支持
marked.setOptions({
gfm: true,
breaks: true
});
const rawHtml = marked.parse("# Hello Markdown");import DOMPurify from 'dompurify';
// 渲染用户输入的 Markdown 时必须使用 DOMPurify 净化 HTML
const cleanHtml = DOMPurify.sanitize(rawHtml);* 在任何 Web 应用中解析外部 Markdown 文本时,务必搭配 DOMPurify 过滤恶意 `<script>` 标签以防范 XSS 攻击。
常见问题解答
Q: 什么是 CommonMark 和 GFM 的区别?
A: CommonMark 是对传统原始 Markdown 歧义语法制定的最严格规范标准;而 GFM(GitHub Flavored Markdown)是在 CommonMark 基础上增加了表格、任务复选框、代码高亮和自动链接等扩展特性的工业界最通用标准。
Q: 可以直接在 Markdown 中写原生 HTML 代码吗?
A: 完全可以。Markdown 原生设计之初就完全兼容内嵌 HTML 标签。当 Markdown 语法无法满足复杂的居中排版、视频嵌入或特定样式时,可以直接书写 `<div align="center">` 或 `<u>` 标签。
Q: 在你们网站预览的代码和草稿会被同步保存吗?
A: 完全不会。本工具不依赖任何云端数据库或远程中转,所有排版和渲染均在您当前浏览器的内存中瞬时完成,刷新或关闭浏览器即清空,保障未发布文稿的绝对隐私。