Question

我的存储库的GitHub页面页面是从README构建的，并且一切正常，但是由于我在README.md中添加了一些图像，因此页面很乱。也许是因为我添加图像的方式？还是吉基臭虫？这是README.md文件的请求：

# Salty Engine
![version-badge](https://img.shields.io/badge/version-0.14.0-orange.svg) ![release-badge](https://img.shields.io/badge/release-0.12.5-brightgreen.svg) ![price-badge](https://img.shields.io/badge/price-free-red.svg) ![license-badge](https://img.shields.io/badge/license-MIT-blue.svg)
<p>

![salty-engine-logo](logos/logo_small.png)

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/

Answer 1

删除徽章后的标签。

# Salty Engine
![version-badge](https://img.shields.io/badge/version-0.14.0-orange.svg) ![release-badge](https://img.shields.io/badge/release-0.12.5-brightgreen.svg) ![price-badge](https://img.shields.io/badge/price-free-red.svg) ![license-badge](https://img.shields.io/badge/license-MIT-blue.svg)
<p>  <=REMOVE THIS

在github.com上，Commonmark用于Markdown解析，而Jekyll使用传统的Markdown解析器。正如规范中的documented一样，CommonMark处理原始HTML的方式与原始Markdown规则的处理方式不同，这解释了输出的差异。

在traditional降价中，块级元素内的所有内容都不会解析为降价文本。而且由于HTML不需要结束标记，因此Markdown解析器假定在开始标记之后的所有内容都位于该段落中。实际上，如果您查看呈现的HTML（使用浏览器的“查看源代码”或“检查”工具），则会发现实际上在文档末尾有一个结束标记。换句话说，整个文档的其余部分被视为位于单个块级原始HTML标记内，因此没有被解析为Markdown（根据规则）。

但是，CommonMark仅在原始HTML中没有空行时才遵循这些规则，从而违反了这些规则。但是，由于打开标记后的第一行是空白行，因此Commonmark立即关闭标记，然后将文档的其余部分解析为普通的Markdown文本。因此，页面在github.com上的呈现方式有所不同。

Answer 2

Github uses GitHub Flavored Markdown（GFM）在您的存储库中呈现markdown文件，并在github.com的Web界面中显示它们。

另一方面，Github Pages / Jekyll使用Kramdown。

为了指示Jekyll解析您的Markdown文件，您必须添加一个最重要的内容。

---
# this is an empty front matter
---
<p>Yolo</p>

第二，您必须configure kramdown来解析块元素内部。

在您的 _config.yml 中：

theme: jekyll-theme-hacker
kramdown:
  parse_block_html: true

GitHub页面页面无法正确构建？

2 个答案: