跳到主要内容

工具推荐

选择合适的工具可以大幅提升 Markdown 编写效率。本章介绍主流的 Markdown 编辑器和相关工具。

编辑器推荐​

跨平台编辑器​

VS Code​

Visual Studio Code 是最流行的代码编辑器，通过插件支持 Markdown 编辑。

优点：

  • 免费开源
  • 丰富的插件生态
  • 内置 Git 支持
  • 实时预览

推荐插件：

  • Markdown All in One：快捷键、自动补全
  • Markdown Preview Enhanced：增强预览、支持数学公式和图表
  • markdownlint：语法检查
  • Paste Image：粘贴图片

适用场景： 开发者、技术文档编写

Typora​

Typora 是一款所见即所得的 Markdown 编辑器。

优点：

  • 所见即所得，无分屏
  • 界面简洁
  • 支持主题自定义
  • 导出格式丰富（PDF、HTML、Word）

缺点：

  • 付费软件
  • 大文件性能一般

适用场景： 博客写作、笔记整理

Obsidian​

Obsidian 是一款基于本地文件的知识管理工具。

优点：

  • 双向链接
  • 知识图谱
  • 丰富的插件
  • 本地存储，数据安全

缺点：

  • 学习曲线较陡
  • 移动端体验一般

适用场景： 知识管理、笔记系统

在线编辑器​

StackEdit​

浏览器中的 Markdown 编辑器，支持离线使用。

特点：

  • 无需安装
  • 支持云同步
  • 支持多种导出格式

网址： https://stackedit.io

Dillinger​

简洁的在线 Markdown 编辑器。

特点：

  • 界面简洁
  • 支持导出 HTML、PDF
  • 支持 GitHub、Dropbox 同步

网址： https://dillinger.io

平台专用编辑器​

MacDown（macOS）​

macOS 平台经典的 Markdown 编辑器。

特点：

  • 免费开源
  • 实时预览
  • 支持自定义样式

iA Writer（macOS/iOS）​

专注于写作体验的编辑器。

特点：

  • 极简界面
  • 专注模式
  • 多平台同步

命令行工具​

Markdown 渲染​

Pandoc​

强大的文档转换工具，支持多种格式互转。

# Markdown 转 HTML
pandoc input.md -o output.html

# Markdown 转 PDF
pandoc input.md -o output.pdf

# Markdown 转 Word
pandoc input.md -o output.docx

安装：

# macOS
brew install pandoc

# Ubuntu
sudo apt install pandoc

# Windows
choco install pandoc

markdown-cli​

Node.js 的命令行 Markdown 工具。

# 安装
npm install -g markdown-cli

# 渲染 Markdown
markdown input.md > output.html

Markdown 检查​

markdownlint​

Markdown 语法检查工具。

# 安装
npm install -g markdownlint-cli

# 检查文件
markdownlint README.md

# 自动修复
markdownlint --fix README.md

表格格式化​

markdown-table-formatter​

格式化 Markdown 表格。

# 安装
npm install -g markdown-table-formatter

# 格式化
md-table-fmt README.md

静态网站生成器​

Docusaurus​

Facebook 开源的文档网站生成器。

特点：

  • 基于 React
  • 内置搜索
  • 版本管理
  • 国际化支持

适用场景： 技术文档、API 文档

Hugo​

Go 语言编写的静态网站生成器。

特点：

  • 构建速度极快
  • 主题丰富
  • 配置灵活

适用场景： 博客、文档站

VuePress​

Vue 驱动的静态网站生成器。

特点：

  • 基于 Vue
  • Markdown 扩展
  • 主题定制

适用场景： 技术文档、博客

Jekyll​

Ruby 编写的静态网站生成器，GitHub Pages 默认支持。

特点：

  • GitHub 原生支持
  • 主题丰富
  • 插件生态

适用场景： GitHub 项目主页、博客

图表工具​

Mermaid Live Editor​

在线 Mermaid 图表编辑器。

网址： https://mermaid.live

Draw.io​

在线绘图工具，支持导出多种格式。

网址： https://app.diagrams.net

Excalidraw​

手绘风格的在线绘图工具。

网址： https://excalidraw.com

图片处理​

图片压缩​

TinyPNG​

在线图片压缩工具。

网址： https://tinypng.com

ImageOptim​

macOS 图片压缩工具。

图片托管​

GitHub​

直接在项目中管理图片。

图床服务​

  • SM.MS
  • ImgBB
  • 阿里云 OSS
  • 腾讯云 COS

格式转换​

表格生成​

Tables Generator​

在线表格生成工具，支持 Markdown 格式。

网址： https://www.tablesgenerator.com

数学公式​

MathJax​

数学公式渲染引擎。

KaTeX​

高性能数学公式渲染引擎。

LaTeX 公式编辑器​

在线 LaTeX 公式编辑器。

网址： https://www.latexlive.com

协作工具​

GitHub/GitLab​

基于 Git 的协作平台，原生支持 Markdown。

特点：

  • 版本控制
  • 协作编辑
  • Issue 追踪
  • Pull Request

Notion​

团队协作文档工具，支持 Markdown 语法。

特点：

  • 实时协作
  • 数据库功能
  • 模板丰富

语雀​

国内协作文档平台。

特点：

  • 中文友好
  • 知识库管理
  • 团队协作

选择建议​

开发者​

推荐组合：VS Code + Markdown All in One + markdownlint

理由：

  • 与开发环境一致
  • 插件生态丰富
  • Git 集成

技术写作​

推荐组合：Typora + Git

理由：

  • 所见即所得
  • 专注写作
  • 版本控制

知识管理​

推荐组合：Obsidian

理由：

  • 双向链接
  • 知识图谱
  • 本地存储

团队协作​

推荐组合：GitHub/GitLab + Markdown

理由：

  • 版本控制
  • 协作流程
  • 免费使用

小结​

本章介绍了 Markdown 相关的工具：

  1. 编辑器：VS Code、Typora、Obsidian
  2. 命令行工具：Pandoc、markdownlint
  3. 静态网站生成器：Docusaurus、Hugo、VuePress
  4. 图表工具：Mermaid、Draw.io
  5. 协作工具：GitHub、Notion

选择工具时，根据自己的使用场景和习惯进行选择。工具只是辅助，重要的是内容本身。

练习​

  1. 安装并配置 VS Code 的 Markdown 插件
  2. 使用 Pandoc 将 Markdown 文件转换为 PDF
  3. 使用 Mermaid Live Editor 创建一个流程图
  4. 尝试使用不同的编辑器，找到最适合自己的