WordPress 原生不完整支持 Markdown，普通段落块仅识别少量简易语法（加粗、列表），表格、代码块、目录、脚注、流程图等必须依靠插件实现。下面分4 种主流方案，覆盖新手、技术博主、批量导入导出需求。
一、方案 1：Jetpack（最轻量，普通博主首选）
适合不想换编辑器、仅简单 Markdown 写作的用户，无需替换 Gutenberg 编辑器。
操作步骤
- 安装并启用 Jetpack 插件，完成站点连接
- 后台 → Jetpack → 设置 → 写作
- 开启：使用纯文本 Markdown 语法撰写文章和页面
- 回到文章编辑，在段落块直接写 MD 语法，实时渲染
优缺点
- ✅ 零额外编辑器、轻量、兼容所有主题
- ❌ 语法阉割：不支持表格、代码高亮、TOC 目录、数学公式
二、方案 2：WP Githuber MD（国内技术博主最强全能编辑器）
完整独立双栏 MD 编辑器，支持 GFM 全语法、代码高亮、流程图、Mermaid、数学公式、目录 TOC，国内使用稳定。
安装配置流程
- 插件 → 安装新插件，搜索
WP Githuber MD安装启用 - 左侧菜单出现 WP Githuber MD → 设置
- 写作设定：勾选文章、页面启用 MD 编辑器
- 模组：开启代码高亮、Mermaid 流程图、目录、表格、数学公式
- 新建文章，顶部切换「Markdown 编辑器」，左侧写 MD、右侧实时预览
核心能力
- 完整 GFM：表格、任务列表、删除线、脚注
- 代码块：几十种编程语言高亮、一键复制代码
- 绘图：Mermaid 流程图 / 时序图、PlantUML
- 自动生成文章目录 TOC、图片懒加载、前端无冗余 JS
三、方案 3：[WP-Editor.md](WP-Editor.md)（开源经典 MD 编辑器）
老牌纯 Markdown 编辑器，界面简洁，分实时预览 / 分屏 / 无干扰写作模式，适合重度文字创作者。 特点：
- 全屏无干扰写作、自定义工具栏
- 支持导入本地
.md文件、导出文章为 MD - 代码高亮、表格、emoji、自动目录
四、方案 4：仅 Gutenberg 专用（导入 / 单独 MD 块）
1. 专用 Markdown 块插件
搜索 Markdown Block，新增独立 MD 区块，粘贴代码 / 笔记，单独渲染，适合局部插入 MD 内容，不全局替换编辑器。
2. HBmarkdown（批量导入本地.md 文件）
适合本地写完 MD 文档，一键导入 WordPress，自动解析 FrontMatter 标题、标签，转换为原生古腾堡区块，支持拖拽上传.md文件。
五、方案 5：导出文章为 MD 文件（LLM/AI 爬虫场景）
插件推荐：LLM Markdown / Berq Markdown 使用方式：访问文章链接末尾加 .md，如 xxx.com/post.md，自动输出带 YAML 头信息的标准 Markdown，用于 AI 抓取、离线备份、同步 GitHub 知识库。
六、通用 Markdown 基础语法（WP 通用）
# 一级标题 ## 二级标题 ### 三级标题 **加粗** *斜体* ~~删除线~~ - 无序列表 - 列表项2 1. 有序列表 > 引用文本 ```php // 代码块 echo "WordPress MD";
| 表头 1 | 表头 2 |
|---|---|
| 内容 1 | 内容 2 |
--- 分割线
## 七、插件选型对比（快速选）
| 插件 | 适用人群 | 核心优势 | 短板 |
|------|---------|---------|------|
| Jetpack | 普通图文博主 | 最轻、不改编辑器 | 缺少表格/代码高亮 |
| WP Githuber MD | 技术博客/教程站 | 全语法、Mermaid、数学公式 | 完整替换编辑器 |
| WP-Editor.md | 文字创作者、写书 | 极简写作界面 | 绘图功能较弱 |
| HBmarkdown | 本地MD批量导入 | 一键上传md文件 | 仅导入，无独立编辑器 |
| LLM Markdown | AI/内容同步 | 前端输出.md链接 | 仅导出，不能编辑 |
## 八、常见踩坑解决
1. **MD图片不显示**
Githuber MD设置开启「自动转换相对图片路径」，本地图片上传媒体库后再写MD。
2. **代码块样式混乱**
开启插件内置代码高亮，关闭主题自带代码样式冲突。
3. **切换编辑器内容丢失**
保存文章后再切换MD/古腾堡编辑器，不要频繁切换。
4. **FrontMatter不生效**
使用HBmarkdown导入本地md才支持，Jetpack原生不识别YAML头信息。
## 九、极简上手推荐路线
1. 普通日常写文：装 Jetpack，够用、无负担
2. 技术/代码/教程博客：**WP Githuber MD**（首选）
3. 本地大量MD文档迁移：HBmarkdown
4. 需要对外输出MD给AI爬虫：LLM Markdown