GitHub pages 页面构建不正确？
GitHub pages page not build correctly?
我的存储库的 GitHub 页面是根据 README 构建的，一切正常，但由于我向 README.md 添加了一些图像，页面变得一团糟。也许是因为我添加图像的方式？或者是一个 Jekyll-bug？
这是 README.md 文件的开头：
# Salty Engine
   
<p>
Salty Engine is a Java library for making a whole 2D Game with only one single library/engine. It aims to be the most user-friendly and easy-to-use 2D Game making tool for Java.
最后，可以在此处找到存储库 -> https://github.com/edgelord314/salty-engine
和这里的页面 -> https://edgelord314.github.io/salty-engine/
删除徽章后的 <p> 标签。
# Salty Engine
   
<p> <=REMOVE THIS
On github.com Commonmark 用于 Markdown 解析，而 Jekyll 使用传统的 Markdown 解析器。正如规范中的 documented，CommonMark 处理原始 HTML 的方式与原始 Markdown 规则不同，这解释了输出中的差异。
在 traditional Markdown 中，块级元素中的所有内容都不会被解析为 Markdown 文本。由于 HTML 不需要结束标记 <p> ，Markdown 解析器假设开始标记之后的所有内容都在该段内。事实上，如果您查看呈现的 HTML（使用您的浏览器 'view source' 或 'inspect' 工具），您会发现实际上在文件的结尾。换句话说，文档的其余部分被视为在单个块级原始 HTML 标记中，因此不会被解析为 Markdown（根据规则）。
但是，CommonMark 打破了这些规则，仅在原始 HTML 中没有空行时才遵循这些规则。但是，由于 <p> 标签后的第一行是空行，Commonmark 会立即关闭 <p> 标签，然后将文档的其余部分作为普通 Markdown 文本进行解析。因此，页面在 github.com.
上呈现不同
Github uses GitHub Flavored Markdown (GFM) 在您的存储库中呈现降价文件，并在 github.com.
的 Web 界面中显示它们
另一方面Github Pages / Jekyll 使用Kramdown。
为了让 Jekyll 解析你的 markdown 文件，你必须添加一个 front matter。
---
# this is an empty front matter
---
<p>Yolo</p>
其次，您必须configure kramdown解析内部块元素。
在你的_config.yml中：
theme: jekyll-theme-hacker
kramdown:
parse_block_html: true
我的存储库的 GitHub 页面是根据 README 构建的，一切正常，但由于我向 README.md 添加了一些图像，页面变得一团糟。也许是因为我添加图像的方式？或者是一个 Jekyll-bug？ 这是 README.md 文件的开头：
# Salty Engine
   
<p>
Salty Engine is a Java library for making a whole 2D Game with only one single library/engine. It aims to be the most user-friendly and easy-to-use 2D Game making tool for Java.
最后，可以在此处找到存储库 -> https://github.com/edgelord314/salty-engine 和这里的页面 -> https://edgelord314.github.io/salty-engine/
删除徽章后的 <p> 标签。
# Salty Engine
   
<p> <=REMOVE THIS
On github.com Commonmark 用于 Markdown 解析，而 Jekyll 使用传统的 Markdown 解析器。正如规范中的 documented，CommonMark 处理原始 HTML 的方式与原始 Markdown 规则不同，这解释了输出中的差异。
在 traditional Markdown 中，块级元素中的所有内容都不会被解析为 Markdown 文本。由于 HTML 不需要结束标记 <p> ，Markdown 解析器假设开始标记之后的所有内容都在该段内。事实上，如果您查看呈现的 HTML（使用您的浏览器 'view source' 或 'inspect' 工具），您会发现实际上在文件的结尾。换句话说，文档的其余部分被视为在单个块级原始 HTML 标记中，因此不会被解析为 Markdown（根据规则）。
但是，CommonMark 打破了这些规则，仅在原始 HTML 中没有空行时才遵循这些规则。但是，由于 <p> 标签后的第一行是空行，Commonmark 会立即关闭 <p> 标签，然后将文档的其余部分作为普通 Markdown 文本进行解析。因此，页面在 github.com.
Github uses GitHub Flavored Markdown (GFM) 在您的存储库中呈现降价文件，并在 github.com.
的 Web 界面中显示它们另一方面Github Pages / Jekyll 使用Kramdown。
为了让 Jekyll 解析你的 markdown 文件，你必须添加一个 front matter。
---
# this is an empty front matter
---
<p>Yolo</p>
其次，您必须configure kramdown解析内部块元素。
在你的_config.yml中：
theme: jekyll-theme-hacker
kramdown:
parse_block_html: true