轻松驾驭：AnQiCMS 如何智能提取和展示文档中的分级标题（H1-H6）
作为一名资深的网站运营专家，我深知内容结构对于用户体验和搜索引擎优化的重要性。在处理大量文档内容时，能够清晰地了解并高效利用文档内部的分级标题（H1-H6）结构，是提升网站内容价值的关键。安企CMS（AnQiCMS）作为一个高效的企业级内容管理系统，在这一方面提供了非常直观且强大的功能。今天，我们就来深入探讨，AnQiCMS是如何帮助我们提取并展示文档内容中的分级标题的。
理解 AnQiCMS 内容结构与 Markdown
首先，我们要明白AnQiCMS在处理内容时，通常是基于其灵活的内容模型进行管理，并且支持强大的Markdown编辑器。这意味着，我们在后台撰写文章、产品介绍、单页面等内容时，可以直接使用Markdown语法来定义标题层级，例如使用一个 # 表示 H1，## 表示 H2，以此类推，直到 ###### 表示 H6。
当这些Markdown格式的内容保存到AnQiCMS的“文档”（Archive）中时，系统会自动解析这些内容，并将其结构化。而正是这种结构化处理，为我们提取和利用分级标题提供了便利。
核心利器：archiveDetail 标签与 ContentTitles 字段
AnQiCMS提供了一个非常实用的模板标签 archiveDetail，它允许我们获取当前或指定文档的详细信息。在这个标签返回的数据中，有一个特别为我们提取分级标题设计的字段，那就是 ContentTitles。
ContentTitles 字段并非直接返回一个字符串，而是一个包含文档所有标题信息的数组对象。这个数组中的每一个元素都代表文档中的一个标题，并且会提供以下关键信息：
Title: 标题的文本内容。Tag: 标题对应的 HTML 标签，例如h1,h2,h3等。Level: 标题的层级数字，例如 H1 对应 1，H2 对应 2。Prefix: 标题前面的前缀，例如自动生成的章节编号。
利用这些信息，我们就可以在模板中轻松构建动态的文档目录或侧边导航。
例如，要在文档详情页的侧边栏展示当前文档的目录，我们可以这样运用 archiveDetail 标签和 ContentTitles 字段：
{# 首先，我们使用 archiveDetail 标签获取当前文档的所有标题信息，并将其赋值给一个名为 contentTitles 的变量 #}
{% archiveDetail contentTitles with name="ContentTitles" %}
{# 接下来，我们判断 contentTitles 变量是否包含任何标题，如果有，则开始构建目录 #}
{% if contentTitles %}
<aside class="document-toc">
<h3>目录</h3>
<nav>
<ul>
{# 循环遍历 contentTitles 数组中的每一个标题项 #}
{% for item in contentTitles %}
{# 根据标题的层级（item.Level）添加不同的 CSS 类或缩进，以便在视觉上区分标题层级 #}
<li class="toc-item level-{{ item.Level }}">
{# 标题前缀（如果有的话）和标题文本 #}
<a href="#{{ item.Title | urlencode }}">{{ item.Prefix }} {{ item.Title }}</a>
</li>
{% endfor %}
</ul>
</nav>
</aside>
{% endif %}
{# 结束 archiveDetail 标签的调用 #}
{% endarchiveDetail %}
在这段代码中，我们巧妙地使用了 item.Level 来为每个目录项添加 level-X 的 CSS 类，这样便可以通过CSS来控制不同层级标题的样式和缩进，使得目录结构一目了然。同时，我们还创建了一个指向 #{{ item.Title | urlencode }} 的链接，这通常需要配合前端JavaScript来实现平滑滚动到页面上对应标题（通常我们会给文档内容中的 H 标签添加 id="{{ item.Title | urlencode }}" 属性）。
实战应用：构建动态文档目录
这种提取分级标题的能力，对于提升用户阅读体验和网站内容管理效率有着显著的价值。
- 自动生成页面目录（Table of Contents, TOC）：如上例所示，我们可以根据
ContentTitles动态生成文档的内部导航目录。用户无需滚动长篇大论，即可快速定位到感兴趣的章节，大大提高了内容的易读性和可访问性。 - 增强内容导航：在一些长篇技术文档或教程中，一个清晰的目录能够帮助用户更好地理解文档结构，并快速跳转到相关内容，减少了用户的寻找成本。
- 支持 SEO 优化：结构化的标题内容本身就是搜索引擎友好的标志。通过
ContentTitles获取的标题数据，可以作为生成页面内锚点链接的依据，有助于搜索引擎更好地理解页面内容结构，甚至可能在搜索结果中以“精选摘要”或“快速链接”的形式展示出来，提升点击率。
优化与扩展：提升文档可读性
除了基础的目录构建，我们还可以进一步利用 ContentTitles 字段提供的数据进行更多高级的优化：
- 侧边栏“当前位置”高亮：结合前端JavaScript，可以监听用户滚动事件，当用户阅读到某一章节时，动态高亮侧边栏目录中对应的标题，为用户提供实时反馈。
- 不同层级标题的样式定制：通过
item.Tag或item.Level，我们可以为 H1、H2、H3 等不同层级的标题应用不同的字体大小、颜色或图标，以更清晰地呈现文档的逻辑层次。 - 内容分析与质量检查：运营人员甚至可以在内容发布前，利用这个功能预览标题结构，检查是否有标题层级混乱、缺失或过于冗长的问题，从而在发布前进行优化。
总而言之，AnQiCMS 的 archiveDetail 标签结合 ContentTitles 字段，为内容运营者提供了一个强大而灵活的工具，能够深度挖掘文档内容的结构价值，不仅提升了用户阅读体验，也为网站的SEO表现增添了助力。通过将技术信息转化为实用的内容运营策略，AnQiCMS真正赋能了中小企业和内容运营团队，让复杂的内容管理变得更加高效和智能。
常见问题 (FAQ)
1. 如果我的 Markdown 文档内容没有在 AnQiCMS 后台发布为“文档”（Archive），而是直接作为服务器上的 .md 文件，还能提取标题吗？
答：archiveDetail 标签是设计用于获取 AnQiCMS 后台管理的“文档”（Archive）内容的。如果你的 Markdown 文件仅仅是存储在服务器文件系统中，并未通过 AnQiCMS 后台导入或创建为具体文档，那么 AnQiCMS 的模板标签无法直接解析这些外部的 .md 文件来提取标题。在这种情况下，你可能需要通过自定义开发（例如编写一个 Go 程序去解析 Markdown 文件并存储到数据库，或者在前端通过 JavaScript 加载并解析 Markdown 文件内容），或者将这些 .md 文件导入到 AnQiCMS 后台作为“文档”来利用其内置功能。
2. ContentTitles 字段提取出的标题列表，是否支持将自定义 CSS 样式应用到目录项中？
答：当然支持。如文章示例所示，ContentTitles 字段为每个标题提供了 Tag 和 Level 信息。你可以在模板中根据 item.Level 或 item.Tag 动态地添加不同的 CSS 类（例如 class="toc-item level-1" 或 `class=“toc-