nuxt content v2 默认会将 markdown 和 html 标题（h2-h6）渲染为带有锚点链接的形式，这可能不符合所有内容展示需求。本教程将指导您如何通过修改 `nuxt.config.ts` 文件中的 `content.markdown.anchorlinks` 配置项，轻松禁用此自动行为，确保标题以纯文本形式呈现，从而实现更灵活的内容展示和更纯粹的排版效果。
理解 Nuxt Content 的标题渲染行为
在使用 Nuxt 3 和 Nuxt Content 2.1 进行 Markdown 内容创作时，开发者可能会遇到一个默认行为：除了 <h1> 标题外，所有更小级别的 Markdown 标题（如 ## header 2 到 ###### header 6）都会被自动转换为带有内部锚点链接的 HTML 元素。这意味着在浏览器中渲染时，这些标题会显示为一个可点击的链接，其 href 属性指向标题本身的 ID。
例如，当您在 Markdown 中写入：
# header 1 ## header 2
Nuxt Content 默认会将其渲染为以下 HTML 结构：
<h1 id="header-1">
<!--[-->
header 1
<!--]-->
</h1>
<h2 id="header-2">
<a href="#header-2">
<!--[-->
header 2
<!--]-->
</a>
</h2>值得注意的是，即使是直接在 Markdown 文件中嵌入原生 HTML <h2> 标签，Nuxt Content 也可能对其进行处理，自动包裹一个锚点链接，有时甚至会出现 href="#undefined" 的情况，这进一步说明了 Nuxt Content 在处理标题时的默认链接生成机制。
这种行为在某些场景下非常有用，例如生成目录或允许用户直接链接到文章的特定部分。然而，在其他场景下，例如仅需要纯粹的标题展示而不需要导航功能时，这种自动生成的锚点链接可能会显得多余或不符合设计预期。
禁用标题自动锚点链接
Nuxt Content 提供了灵活的配置选项来控制这种标题锚点链接的生成行为。您可以通过修改项目根目录下的 nuxt.config.ts（或 nuxt.config.js）文件，来全局禁用 Markdown 标题的自动锚点链接功能。
核心配置项是 content.markdown.anchorLinks。默认情况下，此项可能为 true 或未显式配置而采用默认值（即启用）。要禁用此功能，只需将其设置为 false。
配置步骤：
- 打开您的 nuxt.config.ts 文件。
- 在 defineNuxtConfig 函数内部，找到或添加 content 配置块。
- 在 content 配置块内，找到或添加 markdown 配置块。
- 在 markdown 配置块内，设置 anchorLinks: false。
以下是具体的代码示例：
// nuxt.config.ts
export default defineNuxtConfig({
// ... 其他 Nuxt 配置
content: {
// ... 其他 Content 配置
markdown: {
anchorLinks: false, // 设置为 false 以禁用标题自动生成锚点链接
}
},
// ... 其他 Nuxt 配置
})保存并重启您的 Nuxt 开发服务器后，Nuxt Content 将不再为 Markdown 中的 h2 到 h6 标题自动生成锚点链接。
效果验证
完成上述配置后，当您再次渲染包含 Markdown 标题的内容时，原本会生成锚点链接的标题将以纯粹的 HTML 标题元素形式呈现。
例如，之前的 Markdown 内容：
# header 1 ## header 2
现在将被渲染为：
<h1 id="header-1"> <!--[--> header 1 <!--]--> </h1> <h2 id="header-2"> <!--[--> header 2 <!--]--> </h2>
可以看到，<h2> 标签内部不再包含 <a href="#header-2"> 这样的锚点链接。这使得内容展示更加简洁，符合不希望标题具有点击跳转功能的场景需求。
注意事项与总结
- 全局配置：content.markdown.anchorLinks 是一个全局配置，它会影响所有通过 Nuxt Content 渲染的 Markdown 内容。如果您需要在特定页面或组件中恢复此行为，可能需要考虑自定义渲染逻辑或通过其他方式实现。
- 版本兼容性：本教程基于 Nuxt Content v2.1 及 Nuxt 3。虽然配置项通常保持稳定，但建议查阅 Nuxt Content 的官方文档以获取最新和最准确的配置信息，特别是当您使用不同版本时。官方文档链接：https://www.php.cn/link/365aa59e779547d7e081b220f8fa67ac
- 灵活性：禁用自动锚点链接提供了更大的灵活性，让您可以根据项目的具体设计和用户体验需求，自由控制标题的交互行为。如果将来需要手动添加锚点链接，可以通过自定义 Vue 组件或 Markdown 插件来实现。
通过简单地调整 nuxt.config.ts 文件中的 anchorLinks 配置，您可以轻松管理 Nuxt Content 渲染 Markdown 标题时的行为，从而更好地控制内容的展示效果和用户体验。
