MkDocs(Material)文档双条件过滤方案咨询：文件夹+标签/多标签

方案一：文件夹导航+标签过滤（可行，但需定制） #

MkDocs Material 默认不支持直接在指定文件夹下过滤标签，但可以通过两种方式实现：

• 自定义模板：修改主题的 jinja2 模板，在每个文件夹的索引页（index.md）添加前端筛选组件，通过 JS 读取当前文件夹下所有文档的标签元数据，实现局部标签过滤。
• 插件增强：借助 mkdocs-macros-plugin 或自定义小型插件，在构建时为每个文件夹生成带标签筛选功能的页面，或者在前端动态过滤当前文件夹范围内的文档标签。

适用场景与优缺点 #

• 适合内容有明确层级逻辑（如按项目、业务模块划分）的情况，用户先通过导航定位大类，再细化筛选，符合使用直觉。
• 优点：保留文件夹的结构化分类，降低用户查找内容的认知成本。
• 缺点：需要具备基础的模板修改或插件开发能力，文件夹结构变动时需同步调整筛选逻辑。

方案二：双标签组合过滤（零定制，灵活但需规范） #

弃用文件夹结构，给每篇文档打两个维度的标签（比如一个对应原文件夹的分类标签，一个对应内容主题标签），利用 Material 主题的标签插件或第三方插件实现多标签组合筛选。

适用场景与优缺点 #

• 适合内容分类逻辑模糊、或不想维护复杂文件夹结构的情况，配置简单，无需开发。
• 优点：内容组织更灵活，无需关注文件存储路径，标签云展示也能帮助用户快速发现相关内容。
• 缺点：需投入精力梳理标签体系，统一标签命名（避免重复、歧义），数百篇文档的打标工作量较大；若标签体系混乱，反而会增加用户查找难度。

选择建议 #

• 若内容有清晰层级，且你有一定的模板/插件定制能力，优先选方案一，兼顾结构化导航与精准筛选。
• 若内容分类灵活，或不想投入定制开发精力，选方案二，但必须先梳理好统一的双标签规则（比如「分类标签+主题标签」），确保标签体系清晰。

内容的提问来源于stack exchange，提问作者David Mason