使用 GitHub Markdown 使反引号和链接重叠

Make backticks and links overlap work with GitHub Markdown

我们正在尝试为易于维护的文档实现自动降价生成器。

当提到一个变量的类型时,我们想在它可以为 null 时加上 ? 前缀,在它周围使用反引号并在它的描述中添加一个 link。例如:`?[Article](#article)`.

但是,由于重叠,反引号破坏了 link 语法。我们使用 `?`[`Article`](#article) 来使 link 起作用,但它在 ?Article 之间创建了一个 space,如下所示:?Article.

是否可以仅在 Article 上使用 link 使其看起来像 ?Article

我刚刚测试了一下,发现 ?Article 之间没有 space。看似 space 的东西只是 GitHub 的两个 <code> 方块相互对立的样式。

用反引号包裹整个内容是行不通的,因为反引号表示代码,而 Markdown 将内容视为您要显示源代码的代码示例。

我能找到的最佳解决方法是直接使用 <code> 标签:

<code>?[Article](https://whosebug.com/)</code>

在 GitHub 和 Stack Overflow 上呈现如下:

?<a href="https://whosebug.com/">Article</a>

(我在这里使用 link 作为 Stack Overflow 的 link 目标,所以我们得到一个渲染的 link 作为示例。我希望 #article在您的环境中也同样有效。)

在我看来,这甚至是做你想做的事情的合理方式。 Markdown 的反引号编译为 <code> 标签,并且 inline HTML code is expressly permitted by Markdown:

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags.