问题标签 [commonmark]

我正在创建一个 README.md 文件，我想在其中链接到同一目录中的 COPYING.md。我尝试了以下标记，但未呈现链接：

如何创建这样的链接？（显然，它取决于渲染器和上下文如何解释链接。）

假设我想***cat***使用 CommonMark 标准将字符串解析为 Markdown。该标准说（http://spec.commonmark.org/0.28/#phase-2-inline-structure）：

……

如果找到一个：

弄清楚我们是强调还是强调强调：如果更近的跨度和更开放的跨度的长度> = 2，我们有强的，否则是规则的。

相应地插入一个 emph 或强 emph 节点，在对应于 opener 的文本节点之后。

从分隔符堆栈中删除开启者和关闭者之间的任何分隔符。

从开始和结束文本节点中删除 1（对于常规 emph）或 2（对于强 emph）分隔符。如果它们因此变为空，则删除它们并删除分隔符堆栈的相应元素。如果关闭节点被移除，则将 current_position 重置为堆栈中的下一个元素。

……

根据我对此的阅读，结果应该是<em><strong>cat</strong></em>首先<strong>添加，然后添加<em>. 但是，我在 output 中尝试过的所有在线降价编辑器<strong><em>cat</em></strong>。我错过了什么？

这是我认为应该发生的事情的视觉表示

TextNode[***] TextNode[cat] TextNode[***]

TextNode[*] StrongEmphasis TextNode[cat] TextNode[*]

TextNode[] 强调 StrongEmphasis TextNode[cat] TextNode[]

强调 StrongEmphasis TextNode[cat]

我正在使用 Visual Studio Code 使用它的 Markdown 支持来写一些笔记。我想添加一些表格，但我找不到办法。似乎 Visual Studio Code 实现了 CommonMark，它不包括规范中的表格。

我知道 GitHub 风格的 Markdown 有一个提供此功能的表格扩展，并且有几个表格格式化程序 Visual Studio Code 扩展（此处和此处），但它们只是很好地布局文本。我想在预览窗格中显示一个表格。

有关如何在 Visual Studio Code Markdown 中实现某些表的任何建议？

我按照这些步骤编写了一个演示 HTML。以下是https://github.com/commonmark/commonmark.js#commonmarkjs README 中的步骤：

对于客户端使用，您可以make dist生成一个独立的 JavaScript 文件js/dist/commonmark.js，适合链接到网页，或者从 https://raw.githubusercontent.com/jgm/commonmark.js/master/dist/commonmark获取最新的.js或bower install commonmark.

这是我的演示 HTML。

这是我的演示的 JSFiddle URL：https ://jsfiddle.net/y3xohp7x/

我将这个 HTML 保存在一个名为的文件中foo.html，并用 Firefox 55.0.1 打开了这个本地文件。

但是如果我使用 Firefox 55.0.1 加载它，我会在控制台中收到以下错误。

问题：

1. 为什么会出现这个错误？
2. 如何在无需复制commonmark.js到本地文件系统的情况下解决此错误？
3. 这是我上面引用的 commonmark.js README 文档中的错误，还是我对文档的理解有误？

我正在http://spec.commonmark.org/dingus/试用 CommonMark

我想要以下 HTML 输出，即Foo强调Baz但Bar不强调。

我尝试了各种输入，但没有一个有效。我在下面提供了各种 CommonMark 输入和 HTML 输出的列表，以供尝试无效。

1. 输入：

   输出：

   结果：当然，这不起作用！

2. 输入：

   输出：

   结果：Bar仍然强调。这与 规范中关于 HTML 块的第 7 点一致， 其中明确提到<span>必须出现在自己的行中。

3. 输入：

   输出：

   结果：Baz仍然强调。这一次<span>发生在它自己的线上。为什么它仍然不起作用？

如何在符合 CommonMark 的同时达到预期的效果？

我可以使用 recommonmark 在 Sphinx 中渲染我的 Readme.md 文件。但是当我尝试在 .rst 文件 toctree 中放入多个自述文件时，只能从文档链接访问第一个。

我可以在文件夹结构中看到这两个自述文件，但是当尝试从呈现的 html 页面访问它们时，链接不起作用。

这是文件夹结构的图像。

任何帮助表示赞赏，谢谢！

这是 Sphinx 构建中弹出的错误 -

/workspace/kick_device2/kick/kvm/kvm.rst:16：警告：toctree 包含对没有标题的文档“kick/kvm/tests/README”的引用：不会生成链接

全部，

我正在尝试创建一个扩展（我相信是为了扩展 AbstractBlockParser），它将找到一个开始标记，将后面的行移动到一个块中，然后在找到一个结束标记时停止（在最后一行）。

在查看提供的示例时，很难弄清楚它们如何构建由多行组成的块，例如使用代码围栏，并且文档没有涵盖这种情况。

列表解析器代码似乎显示 ListItems 被添加到 ListBlock，但它如何知道何时停止？

示例降价

输出可能是：

在 Swagger/OpenAPI 2 中，我使用了 Markdown 表，如下所示：

但是在升级到 OpenAPI 3 之后，使用 Commonmark 而不是 Github 风格的 Markdown，似乎不再支持这些表。是否有任何替代方案，或以表格形式显示数据的替代方案？

由于最近的 pandoc 更新（现在我在 2.2.1），docx 文档中的链接被转换为[<span class="underline">graphic novel hero</span>](https://www.amazon.com/exec/obidos/ASIN/1596432594/braipick-20)向链接标签添加不需要的跨度。是否有任何黑魔法（除了添加sed对管道的调用）来摆脱它们并返回纯通用标记？

我使用的 pandoc 选项是：pandoc -f docx --atx-headers --wrap=none --extract-media=. -t commonmark-smart myFile.docx

感谢您的澄清！

在 Ghost 上创建嵌套编号列表的正确语法是什么？文档仅显示单个编号列表的语法，而我尝试过的东西不起作用：

或者：

或者：

现在不可能这么难吧？