markdown - 在 Jekyll（即 Markdown）中，一组 URL 的基本部分可以在链接之间共享吗？

Question

MD 语法允许两种基本的链接方式：[title](link)和[title][reference]. 可以在[reference]文档中多次使用，但仅适用于绝对 URL。

如果我正在写一个代码博客并且经常引用 API 文档，那么很多 URL 的开头都是一样的，例如，http://developer.android.com/reference/android/作为http://developer.android.com/reference/android/content/Context.html. 有没有办法像这样模块化链接？

也许除了 Markdown 之外还有另一个与 Jekyll 兼容的选择？插件？这似乎是一个共同的需求。

相关： 如何在 IPython 中为 markdown 链接设置基本 url？

Answer 1

我个人使用可以在任何帖子或页面中使用的链接库（包含）。

注意：如果站点不在域的根目录（例如：localhost/ 或 example.com/）并且位于子文件夹中（例如：localhost/subfolder/），我们需要在内部链接前面加上site.baseurl的值

<!--- file : _includes/_links_library.markdown --->

<!--- POSTS --->
[welcome]: {{site.baseurl}}{% post_url 2014-09-09-welcome-to-jekyll %}

<!--- PAGES --->
[index]: {{site.baseurl}}/subfolder/
[file]: {{site.baseurl}}/subfolder/file.html

<!--- EXTERNAL PAGES --->
[jekyll]: http://jekyllrb.com/

<!--- ANDROID API REF --->
{% assign androidRef = "http://developer.android.com/reference/android" %}
[context]: {{ androidRef }}/content/Context.html

然后我们只需要包含我们的库就可以使用这样的链接：

---
front matter
---

Link to [welcome post][welcome]
Link to [index][]
Link to [Jekyll doc][jekyll]

{% include _links_library.markdown %}