如何在Posit Connect中正确链接本地HTML文件？

• 核心原因：Posit Connect部署时，resource_files声明的文件会被放置在输出HTML的专属资源子目录中，而非根目录，直接使用main.html作为链接路径会指向错误位置，导致404。

• 修正链接写法：
  使用knitr::resource_path()函数自动生成部署后的正确资源路径，替换原链接代码：

  [main](`r knitr::resource_path("main.html")`)
  

• 额外检查项：

  • 确认resource_files中的文件名拼写完全匹配实际文件，无大小写或后缀错误
  • 部署后查看Posit Connect的部署日志，确认main.html已成功上传至服务器
  • 本地先通过rmarkdown::render()生成HTML并测试链接，排除本地路径问题后再部署

修改后的完整Rmd代码示例：

---
output: html_document
resource_files:
- main.html
---

[parsnip](https://parsnip.tidymodels.org/index.html)

[main](`r knitr::resource_path("main.html")`)

![logo](logo.png)

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