Markdown 表无法在 GitHub 页面上正确呈现

Posted

技术标签:

【中文标题】Markdown 表无法在 GitHub 页面上正确呈现【英文标题】:Markdown Table not rendering correctly on GitHub Pages 【发布时间】:2020-08-22 00:18:29 【问题描述】:

我正在尝试在 Github 页面上的 Markdown 中呈现下表。

---
title: "Abbreviations"
---

| Abbreviation | Definition |
|---|---|
| ADUS | Archived Data User Service |
| APC | Automatic Passenger County |
| AVL | Automatic Vehicle Location |
| DriveNET |
| FHWA | Federal Highway Administration |
| iPeMS |Iteris Performance Management System |
| ITS | Intelligent Transportation Systems |
| MPO | Metropolitan Planning Organization |
| ODOT | Oregon Department of Transportation |
| PSU | Portland State University |
| RITIS | Regional Integrated Transportation Information System |
| VHT | Vehicle Hours Traveled |
| VMT | Vehicle Miles Traveled |
| VPLPH | Vehicles per Lane per Hour |

表格之前正确呈现,然后在进行一些更改后停止。我恢复到在项目的实时版本上正确呈现的格式,并且它继续不呈现为表格,而是呈现为带有很多管道的格式不佳的文本块。在 Markdown 文件的当前 live 版本中,title 后面的 --- 和表头之间没有空行,同样,它工作正常。 *** 上的其他答案表明表格需要在表格标题上方有一个空白行才能正确呈现,所以我将其添加到这个 markdown 文件中,但它仍然无法呈现为表格。我也试过两个空行。

markdown 风格是 CommonMarkGhPages - 这与实时版本不同,但它之前可以正确渲染 CommonMarkGhPages,但现在不再如此。

感谢任何帮助,我没有想法。

【问题讨论】:

【参考方案1】:

_config.yml 中的降价处理器从 CommonMarkGhPages 更改为:

markdown: GFM

【讨论】:

以上是关于Markdown 表无法在 GitHub 页面上正确呈现的主要内容,如果未能解决你的问题,请参考以下文章

markdown 如何使用Jekyll在GitHub页面上嵌入Gist的示例。

markdown 如何使用Jekyll在GitHub页面上嵌入Gist的示例。

Github markdown页面内跳转

markdown GitHub页面命令

css Github Markdown样式表

markdown 如何使用Hexo并部署到GitHub页面