什么是 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. 项目数字 + 点 + 空格
引用> 引用文字可嵌套多层
分割线---三个或更多横线
图片![alt](url)感叹号 + 方括号 + 圆括号

在线预览 Markdown 的步骤

  1. 打开 Markdown 在线预览工具,看到左右分栏界面。
  2. 在左侧编辑区输入或粘贴 Markdown 文本,右侧实时渲染 HTML 预览。
  3. 调整编辑区宽度、切换主题(暗色/亮色),找到最舒适的编辑体验。
  4. 确认渲染效果无误后,可复制渲染后的 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 文件,速工具 的在线预览足够——粘贴即渲染,无需安装任何软件。