GitHub Pages构建失败：HTML-Proofer检测到非void HTML元素标签错误

问题根源 #

报错核心是非空HTML元素误用了自闭合标签（/>）。按照HTML规范，只有<img>、<br>这类无内容的空元素允许自闭合，<div>、<table>等需要包裹内容的非空元素必须用成对的<tag>和</tag>，不能以/>结尾。本地Jekyll预览未触发严格检查，但GitHub Actions里的HTML-Proofer会强制执行该规范。

具体解决方法 #

1. 定位并手动修正错误标签 #

• 打开导出的.md文件，根据报错提示的行号（744行）和位置（1453列），找到对应的HTML标签（比如可能是<div class="output_area"/>这类错误写法）。
• 将自闭合的/>改为>，同时确保该标签有对应的结束标签。例如：
  错误写法：<div class="some-class"/>
  修正为：<div class="some-class">...</div>（若有内容）；如果确实无内容，确认是否应替换为符合规范的空元素标签。

2. 用Pandoc重新转换.ipynb文件 #

Jupyter自带的nbconvert导出的Markdown可能生成不规范的HTML标签，用Pandoc重新转换能生成更合规的内容：

pandoc -s your_notebook.ipynb -o your_post.md

转换完成后，将新生成的.md文件放入_posts文件夹再推送。

3. 修改Jekyll配置绕过检查（不推荐） #

如果暂时无法修改文件，可在_config.yml中调整HTML-Proofer规则，禁用自闭合标签检查：

html_proofer:
  enforce_self_closing_tags: false

注意：此方法仅为临时绕过检查，并非从根源解决标签不规范问题，长期建议优先修正文件。

4. 自定义Jupyter导出模板 #

若频繁需要导出内容，可自定义nbconvert模板避免生成错误标签：

• 复制Jupyter默认的markdown模板（路径通常为python/site-packages/nbconvert/templates/markdown），修改模板中的标签写法，确保非空元素不使用自闭合格式。
• 导出时指定自定义模板：

jupyter nbconvert --to markdown --template /path/to/your/template.tpl your_notebook.ipynb

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