什么是 Markdown
Markdown 是一种轻量级标记语言,2004 年由 John Gruber 创建。它的设计哲学是:用纯文本符号表达格式,源文件即使不渲染也能直接阅读。
// Markdown 源码(纯文本,任何编辑器都能打开)
# 我的标题
这是一段文字,**这部分加粗**,*这部分斜体*。
- 项目一
- 项目二
`echo "这是一行代码"`
// 渲染后效果就是漂亮的 HTML 网页
和 Word 不同,Markdown 文件是纯文本(.md 后缀),用 Git 可以做版本对比、用任何编辑器都能打开、不会出现"你用 Word 2016 我用 WPS 格式乱掉"的问题。GitHub、Stack Overflow、Reddit、Notion 全都支持 Markdown,是现代技术写作的事实标准。
Markdown 基础语法速查
| 效果 | 语法 | 说明 |
|---|---|---|
| # 一级标题 | # 标题 | 1-6 个 # 对应 h1-h6 |
| 加粗 | **文字** | 或用 __文字__ |
| 斜体 | *文字* | 或用 _文字_ |
行内代码 | `code` | 反引号包裹 |
| 代码块 | ```语言 | 三个反引号,可指定语言 |
| [链接](url) | [文字](https://...) | 方括号 + 圆括号 |
| 无序列表 | - 项目 | 用 - * + 均可 |
| 有序列表 | 1. 项目 | 数字 + 点 + 空格 |
| 引用 | > 引用文字 | 可嵌套多层 |
| 分割线 | --- | 三个或更多横线 |
| 图片 |  | 感叹号 + 方括号 + 圆括号 |
在线预览 Markdown 的步骤
- 打开 Markdown 在线预览工具,看到左右分栏界面。
- 在左侧编辑区输入或粘贴 Markdown 文本,右侧实时渲染 HTML 预览。
- 调整编辑区宽度、切换主题(暗色/亮色),找到最舒适的编辑体验。
- 确认渲染效果无误后,可复制渲染后的 HTML 或直接复制 Markdown 源码使用。
所有渲染在浏览器本地完成,Markdown 内容不会被上传到任何服务器。
核心功能一览
实时预览
编辑区输入的同时,预览区即时渲染最终效果,所见即所得。
语法高亮
代码块按语言自动语法高亮,支持 JavaScript、Python、Java 等主流语言。
暗色主题
提供暗色/亮色编辑主题切换,长时间写作不伤眼。
纯本地渲染
浏览器端解析渲染,Markdown 文档不会上传到任何服务器。
常用应用场景
- 写项目 README:GitHub/GitLab 项目首页自动渲染 README.md,是开源项目的名片。
- 技术博客:Hexo、Hugo、VuePress 等静态博客框架用 Markdown 写作,版本管理方便。
- API 文档:用 Markdown 编写接口文档,配合工具可一键生成漂亮的文档网站。
- 笔记与知识管理:Obsidian、Notion、Logseq 等笔记工具内核都是 Markdown。
- 论坛回复:GitHub Issues、Stack Overflow、Reddit 的评论都支持 Markdown 格式。
常见问题 FAQ
Markdown 和 Word 有什么区别?用哪个更好?
Markdown 是纯文本标记语言,源文件就是普通文本,渲染后才看到排版效果。Word 是所见即所得的富文本编辑器。Markdown 更适合:写技术文档、README、博客、笔记(Git 可追踪变更,纯文本跨平台兼容,不会因软件版本导致格式错乱)。Word 更适合:正式公文、排版复杂的报告、需要精确控制页面边距和打印效果的场景。两者的选择看场景,但技术写作领域 Markdown 已是事实标准。
在线 Markdown 预览安全吗?我的文档会上传吗?
速工具 的 Markdown 预览完全在浏览器本地渲染,文档内容不会被发送到任何服务器。你可以在离线状态下将页面打开、粘贴内容即可渲染。
为什么我的 Markdown 表格渲染不出来?
Markdown 表格对格式要求较严格,常见问题:① 表头分隔行(第二行)必须包含至少三个连字符(如 | --- | --- |);② 每列竖线两端可以省略,但同一表格中建议统一写法;③ GitHub Flavored Markdown 要求分隔行与表头行的竖线对齐。如果渲染不出来,可以先粘贴到在线预览工具中逐个排查。
哪款 Markdown 编辑器最好用?
取决于你的需求:Typora — 所见即所得,简洁美观(付费);VS Code + Markdown 扩展 — 免费、功能强大、Git 集成好,适合开发者;Obsidian — 笔记管理 + 双向链接,适合知识体系建设;Notion — 团队协作 + 数据库,但不完全是纯 Markdown。如果只是临时预览一个 .md 文件,速工具 的在线预览足够——粘贴即渲染,无需安装任何软件。