---
inclusion: manual
---

# Mermaid 功能移除总结

## 移除原因

WP-Markdown 编辑器在保存 Markdown 文件时，会将 Mermaid 代码块保存为一整行（没有真正的换行符），导致 Mermaid 解析器无法正确解析，持续报错：`Parse error on line 1: Expecting 'NEWLINE', 'SPACE', 'GRAPH'`。

尝试了多种解决方案（JavaScript 解码、PHP 预处理、智能格式化等）均失败。

## 已移除内容

1. **settings.php** - 移除 Mermaid 设置项和选项保存逻辑（约 15 行）
2. **functions.php** - 移除两个 Mermaid 处理函数（约 70 行）
3. **footer.php** - 移除 Mermaid 加载和渲染代码（约 220 行）
4. **style.css** - 移除 Mermaid 图表样式（约 25 行）
5. **本地镜像** - 删除 `assets/vendor/external/mermaid/` 目录

总计移除约 330 行代码和 2 个本地镜像文件。

## 需求文档

已创建 `mermaid-support-requirements.md` 文档，包含：
- 问题详细分析
- 已尝试的解决方案
- 推荐的替代方案（使用支持 Mermaid 的插件）
- 技术实现参考
- 测试用例

## 推荐方案

使用支持 Mermaid 的 WordPress 插件：
- **WP Githuber MD** - 功能强大的 Markdown 编辑器
- **Markdown Block** - Gutenberg 原生 Markdown 块
- **Code Syntax Block** - 支持 Mermaid 的代码块插件

## Git 提交

```
commit 54cbb40
feat: 移除 Mermaid 支持并创建需求文档

- 从 settings.php 移除 Mermaid 设置项和选项保存逻辑
- 从 functions.php 移除 Mermaid 代码块预处理函数
- 从 footer.php 移除 Mermaid 加载和渲染代码
- 从 style.css 移除 Mermaid 图表样式
- 删除本地镜像文件 assets/vendor/external/mermaid/
- 创建 mermaid-support-requirements.md 需求文档
```