AnQiCMS 为内容创作者提供了灵活多样的编辑体验，其中 Markdown 编辑器的引入，更是让许多熟悉这种简洁标记语言的用户如鱼得水。然而，对于数学公式和流程图这类需要特殊渲染的内容，仅仅启用 Markdown 编辑器还不足够。本文将详细指导您如何在 AnQiCMS 中启用 Markdown 编辑器，并确保您的网页能够正确、美观地显示复杂的数学公式和流程图。
一、启用 AnQiCMS 的 Markdown 编辑器
在 AnQiCMS 后台启用 Markdown 编辑器是一个简单的过程，它将改变您创建和编辑文章内容的默认方式，让您享受到 Markdown 带来的高效与便捷。
首先，请登录您的 AnQiCMS 后台管理界面。在左侧导航菜单中，找到并点击“后台设置”，然后选择“内容设置”。在这个页面，您会看到一个选项，用于切换您的内容编辑器。请确保您已选中“启用 Markdown 编辑器”选项，并保存设置。完成这一步后，您在创建或编辑文档时，就可以直接使用 Markdown 语法来撰写内容了。
二、集成第三方库，确保数学公式正确渲染
Markdown 语法本身虽然简洁高效，但对于复杂的数学公式，它并不具备原生的渲染能力。为了让网页能漂亮地显示您使用 LaTeX 语法编写的数学公式，我们需要借助强大的第三方 JavaScript 库——MathJax。
要集成 MathJax，您需要修改您的模板文件。在 AnQiCMS 中，base.html 文件通常是所有页面的基础骨架，在这里添加代码可以确保所有页面都具备 MathJax 的渲染能力。
请通过后台的“模板设计”功能，或直接通过 FTP/SSH 访问服务器文件，找到您当前使用的模板目录下的 base.html 文件。然后，在 <head> 标签的内部，添加以下 MathJax 引入代码：
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
这段代码会异步加载 MathJax 库。一旦加载完成，MathJax 就会自动扫描页面中的数学公式（例如，用 $$...$$ 或 $...$ 包裹的 LaTeX 语法），并将其转换为清晰、专业的数学排版形式，确保公式在任何设备上都能正确且美观地显示。
三、引入流程图库，让图表生动直观
与数学公式类似，标准 Markdown 也无法直接渲染复杂的流程图。这时，我们可以利用 Mermaid.js 这个强大的 JavaScript 库，它能将文本形式的流程图描述转换为漂亮的矢量图。
同样地，您需要在 base.html 文件的 <head> 标签内部添加 Mermaid.js 的引入代码。请紧随 MathJax 脚本之后，添加以下内容：
<script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
mermaid.initialize({ startOnLoad: true });
</script>
这段代码会导入 Mermaid 库并初始化它，使其在页面加载时自动寻找并渲染使用 Mermaid 语法编写的流程图。您只需在 Markdown 内容中按照 Mermaid 的特定语法（例如，使用 mermaid ... 块）来描述您的流程图，它们就会在网页上以图形化形式展现出来。
四、优化 Markdown 内容的默认样式（可选）
虽然 MathJax 和 Mermaid.js 解决了公式和流程图的渲染问题，但您可能还希望您的 Markdown 内容在整体视觉上更加协调统一。这时，您可以考虑引入一个通用的 Markdown 样式表，例如 github-markdown-css。
同样在 base.html 文件的 <head> 标签内部，添加以下 CSS 样式链接：
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.2.0/github-markdown.min.css" crossorigin="anonymous" referrerpolicy="no-referrer" />
这个样式表将为您的 Markdown 内容提供一套美观、易读的默认样式，使其在网页上呈现出类似 GitHub 风格的舒适阅读体验。
五、确保内容在模板中正确解析与显示
在您的文章模板（例如 detail.html 或 archive.html）中，当您调用 Markdown 编写的内容字段（如 Content）时，请务必使用 |safe 过滤器来确保内容以 HTML 形式输出，而不是被浏览器作为纯文本转义。同时，为了确保 AnQiCMS 后台正确将 Markdown 转换为 HTML，您通常会看到类似这样的调用方式：
{% archiveDetail articleContent with name="Content" render=true %}
{{articleContent|safe}}
这里的 render=true 明确指示 AnQiCMS 后端将 Markdown 内容处理为 HTML，而 |safe 过滤器则允许浏览器将这些 HTML 标签（包括 MathJax 和 Mermaid 渲染后的内容）安全地解析并显示出来。
完成以上步骤后，您可以尝试新建一篇文档，在其中插入一些数学公式（如 $$E=mc^2$$）和流程图（如 mermaid graph TD; A-->B;），然后预览您的页面。您将惊喜地发现，原本枯燥的文本 now 变得生动起来，复杂的数学表达和抽象的流程逻辑都将清晰直观地呈现在读者面前。
常见问题 (FAQ)
Q1: 为什么我启用了 Markdown 编辑器并在文章中添加了公式或流程图，但它们仍然显示为纯文本？
A1: 启用 Markdown 编辑器只是让您能够使用 Markdown 语法来编写内容，但数学公式（LaTeX）和流程图（Mermaid）的渲染还需要额外的 JavaScript 库支持。请务必检查您的 base.html 模板文件中是否已按照本文指导，正确引入了 MathJax 和 Mermaid.js 的脚本。同时，确保您的内容字段在模板中使用了 render=true 和 |safe 过滤器进行输出。
Q2: 我可以在哪里找到更多关于 MathJax 或 Mermaid.js 的语法和使用示例？ A2: MathJax 和 Mermaid.js 都有非常详细和友好的官方文档。您可以通过搜索引擎访问 MathJax 和 Mermaid.js 的官方网站，那里提供了丰富的语法示例、配置选项和故障排除指南，可以帮助您更深入地学习和应用这些工具。
Q3: 如果我不想使用 MathJax 或 Mermaid.js，可以直接在 Markdown 文章中嵌入 HTML 代码来显示公式或图表吗？
A3: 是的，AnQiCMS 的 Markdown 编辑器通常支持在 Markdown 内容中直接嵌入 HTML 代码。只要您的模板在输出内容时使用了 |safe 过滤器，嵌入的 HTML 代码就会被浏览器解析并显示。但是，手动编写和维护 HTML 通常不如 MathJax 或 Mermaid.js 的文本描述方式简洁高效，尤其是在需要频繁修改或大量内容时。