使用Hugo修复Blogdown文章RSS订阅中的相对链接失效问题

错误根源 #

你使用的Hugo短代码存在语法错误：{{< blogdown/postref >}foo.png}里的短代码闭合符号写错了。Hugo短代码的正确格式是{{< 短代码名称 >}}，你把末尾的}}误写为}，导致Hugo解析时识别到非法的单独>字符，触发了报错信息里的unrecognized character in shortcode action问题。

修复步骤 #

1. 修正短代码语法
   将所有错误的图片路径代码：

   ![]({{< blogdown/postref >}foo.png})
   

   改为正确的格式：

   ![]({{< blogdown/postref >}}foo.png)
   

   核心是把短代码部分的>}修正为>}}，确保短代码的起止符号配对完整。

2. 验证修复效果
   重新运行blogdown::serve_site()，检查站点是否能正常构建。构建完成后，查看RSS订阅内容中的图片链接，确认已转换为绝对路径。

3. 批量替换优化（可选）
   如果需要批量修改Rmarkdown文档中的图片路径，可在R中用正则表达式批量处理，避免手动修改的繁琐和错误：

   library(stringr)
   # 读取目标Rmd文件内容
   content <- readLines("your-post-file.Rmd")
   # 批量替换图片路径格式
   new_content <- str_replace_all(content, "!\\[(.*?)\\]\\((.*?)\\)", "!\\[\\1\\]({{< blogdown/postref >}}\\2)")
   # 写入修改后的内容
   writeLines(new_content, "your-post-file.Rmd")
   

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