如何在AnQiCMS中启用Markdown渲染，正确显示数学公式和流程图？
在AnQiCMS中，想要让你的内容更具表现力，特别是需要展示复杂的数学公式或清晰的流程图时，灵活运用Markdown编辑器是一个非常有效的方案。新版本的AnQiCMS已经为此提供了良好的支持。接下来，我们将一起探索如何在AnQiCMS中启用这些功能，让你的网站内容焕发新生。
第一步：开启Markdown编辑器
要开始使用Markdown撰写内容，我们首先需要在AnQiCMS的后台设置中启用它。这很简单，只需要几个点击就能完成。
请登录您的AnQiCMS后台，导航到“全局设置”，然后选择“内容设置”。在这个页面中，您会找到一个名为“Markdown编辑器”的选项。请将其状态设置为“启用”并保存您的更改。
完成这一步后，当您在后台创建或编辑文章、产品详情或单页面内容时，原有的富文本编辑器界面将会被Markdown编辑器取代。这意味着您可以直接使用Markdown语法进行内容创作，大大提高编辑效率和内容的结构化程度。
第二步：为Markdown内容应用美观的默认样式
虽然Markdown编辑器让内容创作变得便捷，但Markdown语法本身只定义了内容的结构，并没有定义它们的显示样式。为了让您的Markdown内容在前端页面上看起来专业且美观，我们需要引入一套通用的Markdown渲染样式。
我们推荐使用github-markdown-css，这是一套广受欢迎的GitHub风格Markdown样式。您可以通过CDN（内容分发网络）轻松将其集成到您的网站中。
请找到您的网站模板文件，通常在 /template 目录下，其中 base.html 文件是您网站所有页面共享的基础骨架。打开 base.html 文件，并在 <head> 标签的末尾，</head> 之前，添加以下一行代码：
<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" />
保存 base.html 文件后，您的网站就具备了渲染GitHub风格Markdown内容的能力。发布Markdown文章后，它们将自动应用这套简洁且易读的样式。
第三步：让数学公式在网页上正确显示
对于需要在文章中插入数学公式的用户，AnQiCMS同样提供了解决方案。通过集成MathJax这个强大的JavaScript显示引擎，您的网站能够优雅地渲染LaTeX、MathML或AsciiMath格式的数学公式。
同样地，您需要在 base.html 文件的 <head> 标签内，紧接着上一步添加的CSS样式之后，插入以下脚本代码：
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
现在，您就可以在Markdown内容中使用LaTeX语法来编写数学公式了。例如，使用 $ 包裹的内联公式 $E=mc^2$，或者使用 $$ 包裹的块级公式：
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
这些公式在页面上将由MathJax渲染成清晰可辨的数学符号。
第四步：在网页上绘制清晰的流程图
流程图是可视化复杂过程、系统架构或决策路径的利器。AnQiCMS通过集成Mermaid库，让您能够直接在Markdown中编写文本，并将其自动转换为美观的流程图。
请继续在 base.html 文件的 <head> 标签内，在MathJax脚本之后，添加以下脚本代码：
<script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
mermaid.initialize({ startOnLoad: true });
</script>
配置完成后，您就可以在Markdown内容中创建Mermaid流程图了。只需使用特殊的Mermaid代码块，例如：
graph TD;
A[用户] --> B(提交表单);
B --> C{验证数据?};
C -- 是 --> D[处理数据];
C -- 否 --> E(显示错误);
D --> F[保存成功];
F --> G[通知用户];
这些简单的文本描述将会在您的网页上自动渲染成专业的流程图。
撰写和发布Markdown内容
完成了以上所有配置后，您就可以在AnQiCMS的后台编辑器中尽情发挥了。当您新建或编辑文档时，只需在Markdown编辑器中直接输入Markdown语法，包括数学公式的LaTeX代码和流程图的Mermaid代码。AnQiCMS会负责在前端页面上进行渲染和展示，让您的内容既专业又易于理解。
常见问题 (FAQ)
1. 我已经启用了Markdown编辑器，并在文章中写了公式和流程图，但前台没有显示出来，或者样式不对，怎么办？
首先，请确保您按照文章中的步骤，在您网站的 base.html 文件中正确引入了 github-markdown-css 样式表，以及 MathJax 和 Mermaid 的 JavaScript 脚本。请仔细检查文件路径和代码是否有任何拼写错误，或者CDN链接是否有效。同时，确保这些代码确实放置在 <head> 标签内部。有时，浏览器缓存也可能导致问题，尝试清除浏览器缓存后再访问页面。
2. 我只想在部分文章中使用Markdown渲染，而不是全部文章，可以实现吗？
AnQiCMS的Markdown编辑器启用后，您在其中编辑的内容默认都会以Markdown格式存储和渲染。如果您需要在特定情况下禁用或强制启用Markdown渲染，可以在调用内容字段的模板标签上进行控制。例如，使用 {% archiveDetail archiveContent with name="Content" render=false %}{{archiveContent|safe}}{% endarchiveDetail %} 可以强制关闭Markdown渲染。反之，render=true 则可以强制启用Markdown渲染，即便全局设置中未启用编辑器。
3. 我的流程图和数学公式显示正常，但是Markdown的整体样式看起来还是不太对劲，和示例图片不一样。
这通常是因为您的网站模板可能自带了一些全局CSS样式，这些样式可能会覆盖或影响 github-markdown-css 的效果。您可以尝试使用浏览器的开发者工具（通常按F12键打开），检查Markdown元素所应用的CSS规则。通过调整您自定义CSS的优先级（例如使用更具体的选择器或 !important，但后者需谨慎使用），或者少量修改您的模板CSS，通常可以解决样式冲突问题，让Markdown内容按照预期显示。