在 Markdown 中以及使用 Jekyll 构建后都有效的链接

Question

我目前正在创建一个多页 Markdown 文档，我想将其用作简单的 Markdown 参考和 Jekyll 站点的源代码。我在以适用于两个世界的方式制定链接时遇到了麻烦。

显然，我尝试在 Markdown 文档中设置简单的链接，如下所示：

[some link](path/to/file.md)

这与任何 Markdown 查看器都能很好地配合，允许用户浏览 Markdown 文档。

但是，这并不符合 Jekyll 的预期。编译后，Jekyll 将这些链接翻译为

<a href="path/to/file.md">some link</a>

当然，这不是我想要的。我希望它链接到翻译后的

path/to/file.html

（或者可能是

path/to/file/index.html

或其他）。

我发现 Jekyll 理解各种建立链接的方法。例如，这会触发翻译：

[some link](path/to/file)

但是，如果我使用 Jekyll 特定的语法编写链接，我就无法再将代码与 Markdown 查看器一起使用。有什么方法可以制定适用于两个世界的链接吗？

Answer 1

您可以使用此 gem 来实现预期的行为： https://github.com/benbalter/jekyll-relative-links

请注意，您可能需要启用转换集合链接：

relative_links:
  enabled:     true
  collections: true