在MkDocs中添加外部URL链接的正确方法是什么?
MkDocs导航栏配置外部跳转链接失效的解决方法
你当前使用的配置写法本身符合MkDocs语法规范,1.0及以上版本的MkDocs原生支持直接在导航栏配置外部链接,配置失效可以按照以下步骤排查解决:
- 确认MkDocs版本符合要求
执行命令mkdocs --version查看当前安装的版本,若版本低于1.0,原生不支持导航栏外部链接配置,执行pip install --upgrade mkdocs升级到最新稳定版即可。 - 检查所用主题的适配性
主流官方主题(如mkdocs-material、readthedocs)的最新版本均已适配导航外部链接跳转逻辑,如果你使用的是二次开发的自定义主题,需要检查导航渲染模板的逻辑:需判断链接如果以http/https开头就直接输出原生地址,不要自动拼接站点根路径。 - 排查插件冲突
部分路由处理类插件(如导航自动生成、路径重写类插件)可能会篡改导航链接的生成规则,你可以先临时禁用所有非必要插件,测试跳转是否恢复正常。
正确的导航外部链接配置示例如下:
nav: - Home: index.md - 'Document': 'https://www.google.com/'
内容的提问来源于stack exchange,提问作者user15826601
相关产品推荐
相关产品推荐

