mkdocs使用snippets扩展时--8<--引入语法未解析问题咨询

• 优先检查路径拼写错误：你示例中写的路径是includes/other_rep/oher_fragment1.md，大概率存在拼写错误（应为other_fragment1.md），snippets扩展在匹配不到对应路径的文件时，不会做任何处理，会直接保留原始语法输出。
• 检查base_path配置规则：确认mkdocs.yml中snippets扩展的base_path参数配置，如果你设置了固定的根目录，所有片段路径都需要从base_path对应的目录开始计算，相对路径计算错误会直接导致解析失效。
• 确认路径计算基准：snippets扩展的路径默认是相对于mkdocs.yml所在的项目根目录，不是相对于当前引用片段的md文件所在目录，如果file1.md和file2.md不在同一级目录，要注意不要按当前文件相对路径写引用地址。
• 检查扩展冲突：确认mkdocs.yml的markdown_extensions列表中没有重复配置snippets扩展，也没有其他自定义扩展使用--8<--语法规则，扩展优先级抢占会导致snippets没有机会解析对应语法。
• 检查文件权限：确认includes/other_rep/目录及目录下的所有片段文件有可读权限，权限不足时snippets会跳过解析流程。
• 开启调试日志定位问题：可在mkdocs.yml的snippets配置中添加check_paths: true参数，构建时会在控制台输出路径检查的错误信息，可直接定位具体问题。

内容的提问来源于stack exchange，提问作者Sebastien Hoarau