Quarto网站：如何插入保留原路径的链接？

当Quarto站点部署在主机子目录（如www.example.com/qsite/）时，若要添加指向主机根路径（如/、/static、/shiny）的链接且避免被Quarto转为相对路径，可采用以下几种方法：

• 直接使用原生HTML链接：在.qmd文件中直接编写HTML格式的链接，Quarto不会对HTML标签内的href属性进行修改。例如：

  <a href="/">主站首页</a>
  <a href="/static">静态资源页</a>
  

• 使用Raw代码块包裹链接：通过raw代码块让Quarto原样输出内容，不进行路径转换。示例：

  <a href="/shiny">Shiny应用页</a>
  

• 配置Quarto的URL处理选项：在_quarto.yml中确保site-url已正确设置为http://www.example.com/qsite/，同时可以尝试添加relative-urls: false配置，强制使用绝对URL逻辑（此选项可能影响其他相对链接，需测试验证）：

  website:
    site-url: http://www.example.com/qsite/
    relative-urls: false
  

以上方法中，直接使用原生HTML链接是最可靠且无需额外配置的方式，能确保根路径链接不被Quarto修改。

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