【问题标题】:Github vs npm markdown, escaping vertical barGithub vs npm markdown,转义竖线
【发布时间】:2017-04-25 13:17:38
【问题描述】:

对于 Github markdown 中的表格单元格,您必须使用 \ 转义 | 以避免将其解释为下一个单元格。一旦你逃脱它,一切都很好,例如https://github.com/russellw/clause-normal-form Nor 和 Or 的条目。

对于 npm markdown 中的表格单元格,这不起作用; \ 出现在显示屏中,例如https://www.npmjs.com/package/clause-normal-form Nor 和 Or 的条目。

如何在自述文件中的表格中转义|,以便 Github 和 npm 都能正确显示?

【问题讨论】:

    标签: node.js npm markdown github-flavored-markdown


    【解决方案1】:

    <code>| | | | |</code>

    以上渲染为:| | | | |

    您应该能够在 Markdown 中使用 HTML 实体,并且 <code></code> 代替反引号将避免 & 在内部自动转义为 &。当然,根据您的具体示例,您可能还有其他一些需要转义的字符。

    更多实体见:https://dev.w3.org/html5/html-author/charref

    记住你可以在 Markdown 中使用 HTML(包括 HTML 实体):

    对于 Markdown 语法未涵盖的任何标记,您只需使用 HTML 本身。无需为它加上前缀或定界以表明您正在从 Markdown 切换到 HTML;你只需使用标签。

    见:https://daringfireball.net/projects/markdown/syntax#html

    【讨论】:

    • 啊!这确实适用于纯文本,谢谢。剩下的问题是,在这种情况下,竖线是运算符的名称,因此应该以代码字体格式化,这通常通过在反引号之间放置东西来完成,但在这种情况下会破坏 HTML 实体。有没有办法让它们以代码字体呈现?
    • @rwallace 您可以尝试使用<code>ABC</code> 而不是反引号。
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2021-12-15
    • 2018-10-26
    • 1970-01-01
    • 2022-01-08
    • 2017-05-14
    相关资源
    最近更新 更多