问题

搜索引擎根据结构对内容进行优先级排序。如果一篇高质量指南使用“简介”或“步骤 1”等通用标题，搜索引擎可能无法为隐藏在段落中的核心关键词分配足够的权重。这导致相关页面被埋没在搜索结果深处，令期望立即获得答案的用户感到沮丧。

为什么重要

用户通常搜索特定的技术术语（例如“身份验证令牌”或“部署限制”），而不是完整的句子。如果您的文档结构没有强调这些术语，搜索引擎就无法自信地对您的内容进行排名。高搜索相关性是实现文档门户“自助化”与处理大量支持工单之间的区别。

方法

组织您的 Markdown，以便搜索索引器能够自动识别并优先处理核心概念。docmd 的搜索引擎为页面 title（标题）、description（描述）和 headers（标题行）分配的权重高于正文文本。通过优化这些结构化元素，您可以显著提高内容的发现率。

实施

1. 优化 Frontmatter 元数据

使用 Frontmatter 块提供明确的关键词和描述性摘要。搜索插件 会索引这些字段，以便在搜索 UI 中提供更好的结果和更有用的片段。

---
title: "AWS S3 存储配置"
description: "如何为 AWS S3 集成配置 IAM 角色和存储桶权限。"
keywords: ["aws", "s3", "storage", "iam", "cloud"]
---

2. 使用语义化标题

避免使用通用的标题名称。相反，在标题中包含相关的关键词，为用户和搜索引擎提供上下文。

• 低相关性： ## 步骤 1：配置
• 高相关性： ## 步骤 1：配置 AWS IAM 角色

3. 利用标注强调关键信息

使用 标注容器 (Callout Containers) 来显示关键警告或“专业技巧”也可以提高搜索相关性。标注中的内容通常在语义上是独立的，索引器可以对其进行不同的权重处理，以突出显示重要的故障排除步骤。

权衡

优化搜索相关性需要严谨的写作。随着产品的演进，Frontmatter 中的关键词如果不及进行定期检查，可能会变得过时。此外，在标题中包含过多关键词（关键词堆砌）会使文档显得重复且读起来不够自然。请在 SEO 和可读性之间寻求平衡。