运行blogdown::serve_site()时查看器无预览且报toml解析错误如何解决？

1. 提交指定shortcode文件到GIT的操作步骤 #

• 先切换到站点根目录（即包含.git文件夹、config.toml的目录，对应你的路径为C:\Users\User\Documents\20210913_blogdown\web-tea），如果还未初始化Git仓库，先执行git init完成初始化
• 执行命令将目标文件添加到暂存区：
  git add layouts/shortcodes/blogdown/postref.html
• 执行提交命令完成提交：
  git commit -m "add required blogdown postref shortcode"

2. 站点无预览的原因说明 #

站点无法加载预览的直接原因是config.toml的TOML解析错误，和shortcode文件未提交没有关联：

• 报错toml: table markup already exists说明config.toml中重复定义了[markup]配置块，Hugo加载配置时检测到重复的表定义会直接启动失败，因此不会生成预览内容
• shortcode文件未提交仅为blogdown给出的版本管理规范提示，不影响本地站点的启动和预览，即使该文件未提交，只要配置正确站点也可以正常加载

补充解决方法：打开config.toml文件，搜索[markup]配置头，删除重复的配置块，仅保留一份完整的[markup]配置即可，修改保存后重新运行serve_site()就能正常加载预览。

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