You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.05 18:24:01