Github和npm的markdown有何不同？

Question

我在 Github (https://github.com/jrootham/argument-spec) 和 npm (https://www.npmjs.com/package/argument-spec) 上有一个 Node 包。其中有一个规范表格，第一个单元格包含单词 'undefined'。该表格在 Github 上显示正常，但在 npm 上是空白的。有人知道出了什么问题吗？我搜索了 npm markdown 的文档，但没有找到相关内容。

- Jim Rootham

Answer 1

如果使用evilstreak/markdown-js生成npm自述文件的html页面（如这个问题中所示），那么你可以得到一些表格示例，比如这个：

| First Header | Second Header |
| ------------- | ------------- |
| Content 1 | Content 2 |
| Content 3 | Content 4 |

这里有一个230号问题，讨论了该软件包对表格的适当支持，但它应该能够正确渲染大多数表格。

在你的情况下，请尝试添加分隔符，看看是否会有所改变：

####Specification meanings

|Specification|Valid argument|
-----------|----------
|undefined|anything|
|''|string|

---

PR (拉取请求480提到：

这次更新newww使用了marky-markdown来处理readme内容。亮点包括：

• 易于阅读的代码！
• 大量测试
• 明确的HTML内容策略，带有sanitize-html
• 服务器端语法高亮
• Gravatar URL清理
• GitHub相对链接清理
• 更好地标记徽章元素
• 前瞻性CDN图片支持

该项目反过来使用markdown-it，它有一些关于表格的问题。

- VonC

---

有什么办法可以找出npm使用的哪个markdown？我还注意到npm没有将#字符串解释为标题级别。我是否被困在github npm不兼容性中了？ - Jim Rootham

@JimRootham，这里有一些提示：https://github.com/npm/docs.npmjs.com/search?utf8=%E2%9C%93&q=markdown 和 https://github.com/npm/newww/search?utf8=%E2%9C%93&q=markdown。 - VonC

@JimRootham 我已经编辑了答案，并提供了更具体的参考，涉及npm用于处理“README”页面的项目。 - VonC

Answer 2

@Jim Rootham关于 npm 显示 markdown 的流程是正确的：它们会经过 marky-markdown 过滤，然后显示。看起来您在这个过程中发现了一个 bug；您应该在 npm 网站存储库 https://github.com/npm/newww 上开启一个 issue。

- Sam Mikes

---

你在“@Jim Rootham is right…”中实际上是指“@VonC is right”吗？因为我是这个页面上唯一建议使用marky-markdown的人。 - VonC

抱歉，我把错误的名称与评论关联了起来。对不起 VonC。 - Sam Mikes