AnQiCMS如何启用Markdown编辑器来编写文档内容？
作为一位深谙安企CMS(AnQiCMS)运营之道的内容专家，我很高兴能为您详细解读如何在AnQiCMS中启用并充分利用Markdown编辑器来创建和管理您的文档内容。在数字时代，Markdown以其简洁高效的特性，成为内容创作者的利器。AnQiCMS深知其价值，在新版本中引入了Markdown编辑器，极大地提升了内容编辑的灵活性和便捷性。
启用安企CMS中的Markdown编辑器
要开始使用AnQiCMS的Markdown编辑器，您需要首先在系统后台进行简单的设置。这一步骤是激活Markdown功能的关键。
前往AnQiCMS的后台管理界面。在左侧导航菜单中，找到并点击“后台设置”，然后选择“内容设置”。在内容设置页面中，您会找到一个选项，用于启用或禁用Markdown编辑器。请确保将此选项设置为启用状态。完成设置后，保存更改，您的AnQiCMS系统便已准备好支持Markdown内容创作。
在网页上应用Markdown默认样式
启用Markdown编辑器后，为了让您的Markdown内容在网站前端呈现出美观且易读的效果，特别是带有代码块、引用等元素的文档，建议您引入一套Markdown样式。GitHub Flavored Markdown (GFM) 样式是目前广泛接受且视觉效果优秀的选择。
您可以通过引入CDN资源来快速应用这些样式。通常，这需要在您网站模板的base.html文件（或任何作为所有页面基础的模板文件）的<head>标签内添加一行代码。例如，您可以添加以下链接来引入GitHub Markdown样式：
<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内容在转换为HTML后，就能自动拥有类似GitHub的专业排版风格。
网页上数学公式的正确显示
对于那些需要展示数学公式的文档，Markdown编辑器本身虽然能识别公式语法，但要在网页上正确渲染这些公式，还需要借助专门的JavaScript库。MathJax是一个功能强大的数学排版引擎，能够将LaTeX、MathML等格式的数学公式转换为高质量的网页显示效果。
要在AnQiCMS中启用数学公式的渲染，您同样需要在网站模板的base.html文件（或您的通用模板文件）的<head>标签内添加一段MathJax的CDN引用脚本：
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
添加此脚本后，您在Markdown中编写的数学公式（如使用$$...$$或$...$包裹）便能在前端页面中被正确解析和显示。
网页上流程图的正确显示
除了数学公式，有时您的文档可能还需要包含流程图或序列图，以更直观地表达复杂逻辑。Mermaid是一个基于Markdown的图表绘制工具，允许您通过简洁的文本语法创建各种图表。
要在AnQiCMS前端支持Mermaid流程图的显示，您需要在base.html文件（或您的通用模板文件）的<head>标签内添加Mermaid的CDN引用脚本。请注意，Mermaid需要type="module"的脚本类型：
<script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
mermaid.initialize({ startOnLoad: true });
</script>
这段脚本会导入Mermaid库并初始化它，使其能够在页面加载时自动渲染Markdown中定义的流程图。
使用Markdown进行内容创作
一旦Markdown编辑器及其相关渲染功能被启用，您就可以在AnQiCMS的多个内容创作区域享受Markdown带来的便利了。这包括但不限于：
- 文档内容：在创建或编辑文章、产品等文档时，文档内容字段将支持Markdown语法。
- 分类内容：编辑分类时，其描述或详情内容也可以使用Markdown。
- 单页面内容：创建“关于我们”、“联系我们”等单页面时，页面内容可使用Markdown编写。
- 标签内容：为标签添加详细描述时，同样可以利用Markdown。
AnQiCMS的Markdown编辑器会在您保存内容时，自动将Markdown语法转换为HTML，并在前端页面进行展示。对于需要在模板中手动控制Markdown渲染的情况，例如某些特定的内容字段，您可以在模板标签中通过render=true参数显式地触发Markdown到HTML的转换，或通过render=false参数阻止自动转换，以便进行更精细的控制。
例如，在archiveDetail标签中，文档内容Content字段可以这样控制渲染：
{# markdown 转 html #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}</div>
{# 不进行markdown转换 #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" render=false %}{{archiveContent|safe}}</div>
通过以上步骤，AnQiCMS的用户可以充分利用Markdown的优势，以更高效、更结构化的方式创作和管理网站内容，同时确保在前端呈现出专业且功能丰富的视觉效果。
常见问题解答 (FAQ)
1. 为什么我开启了Markdown编辑器，但在文档详情页看不到数学公式或流程图的渲染效果？
Markdown编辑器开启后，AnQiCMS会在后台将Markdown内容转换为HTML。然而，数学公式和流程图的渲染需要前端浏览器加载特定的JavaScript库来解析这些HTML中的特定标记（如$$...$$或graph TD;），并将其转换为视觉图像。您需要按照文章中“网页上数学公式的正确显示”和“网页上流程图的正确显示”章节的指引，将MathJax和Mermaid的CDN脚本添加到您网站模板的<head>标签内。
2. 我使用的是自定义主题，在哪里可以找到base.html文件来添加CDN脚本？
在AnQiCMS中，模板文件的根目录是/template。您的自定义主题通常会在这个目录下拥有一个独立的文件夹（例如/template/yourtheme/）。base.html文件一般是您主题的通用布局文件，它可能直接位于主题根目录，也可能位于公共代码目录（例如yourtheme/bash.html或yourtheme/partial/header.html，然后被其他模板引用）。您需要根据您主题的具体结构来查找并编辑这个作为页面基础的HTML文件。
3. 启用Markdown编辑器后，旧的HTML内容会受到影响吗？
不会。Markdown编辑器主要影响您新创建或编辑时使用Markdown语法输入的内容。对于已有的纯HTML内容，AnQiCMS会将其视为普通HTML进行处理，并不会尝试将其转换为Markdown再渲染，因此您无需担心旧内容被错误解析或损坏。Markdown功能是增量式的，旨在提供一种新的内容创作方式。