Github-pages/kramdown 无法正确呈现我的混合 markdown/html

Github-pages/kramdown won't render my mixed markdown/html correctly

我有一个混合的HTML/Markdown页面,我认为很简单,但是Github-pages给出了莫名其妙的效果图。

配置为使用kramdown/GFM。

这是让我兴奋的代码:

QuickFIX Settings
-----------------

* [Session](#session)
* [Validation](#validation)
* [Initiator](#initiator)
* [Acceptor](#acceptor)
* [Socket Configuration](#socketConfiguration)
* [Storage](#storage)
* [File Storage](#file)
* [Logging](#logging)
* [SSL](#ssl)
* [Sample Settings File](#sample)

<a name="session"/>

## Session

<table>
  <tr>
    <th>Setting</th>
    <th>Description</th>
    <th>Valid Values</th>
    <th>Default</th>
  </tr>

[more table code follows...]

当我在其他 Markdown 解析器(例如 Issue 描述解析器)中预览 markdown 代码时,没问题。但是当我把它推到 gh-pages 分支时,我得到了这样的垃圾:

为什么那些 tr-close 和 table-close 标签在那里? (甚至还没有 table 开始!)为什么 table 实际上出现在 next header?

下面

这一切都说不通!

这是一个 open-source 项目,因此您可以在此处查看当前实时渲染和源代码:

你的 table 被破坏的原因是你的 table 中的不平衡(未关闭)td,有效地破坏了 HTML 流:

  <tr>
    <td class='setting'>SendRedundantResendRequests</td>
    <td class='description'>
<!-- ^-- this td element is never closed -->
      If set to Y, QuickFIX will send all necessary resend requests, even if they appear redundant.
      Some systems will not certify the engine unless it does this.
      When set to N, QuickFIX will attempt to minimize resend requests.
      This is particularly useful on high volume systems.
    <td class='valid'>
      <div>Y</div>
      <div>N</div>
    </td>
    <td class='default'>N</td>
  </tr>