jekyll markdown内部链接

Question

Jekyll使用Markdown格式的链接，但我如何链接到内部内容？

[[link]] 

Answer 1

您现在可以使用以下内容发布内部链接：

[Some Link]({% post_url 2010-07-21-name-of-post %})

这也在Jekyll Documentation中引用。

https://github.com/mojombo/jekyll/pull/369

Answer 2

对于网页they decided not to add a page_url tag，因为您无论如何都必须知道网页的路径。所以你只需要手动链接到它：

[My page](/path/to/page.html)

如果你想以编程方式获得页面标题，你可以做一些大而丑的事情：

{% for page in site.pages %}
  {% if page.url == '/path/to/page.html' %}
[{{ page.title }}]({{ page.url }})
  {% endif %}
{% endfor %}

Answer 3

现在可以使用link标记链接到帖子以外的网页。 link适用于帖子，页面，集合中的文档和文件。

{{ site.baseurl }}{% link _collection/name-of-document.md %}
{{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %}
{{ site.baseurl }}{% link news/index.html %}
{{ site.baseurl }}{% link /assets/files/doc.pdf %}

请记住在使用link标记时包含文件扩展名。 要用它来创建链接：

[Link to a document]({{ site.baseurl }}{% link _collection/name-of-document.md %})
[Link to a post]({{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %})
[Link to a page]({{ site.baseurl }}{% link news/index.html %})
[Link to a file]({{ site.baseurl }}{% link /assets/files/doc.pdf %})

请参阅Jekyll Documentation。

Answer 4

Jekyll有多种链接方式，其中一些现在已经过时了。

使用链接标记

链接到内部文件的推荐方法是

[Link]({{ site.baseurl }}{% link path/to/file.md %})

请注意，如果文件移动或被删除，这将导致错误。

永久链接

链接到页面而不会导致错误（改为链接断开）：

[Link]({{ '/path/to/page/' | relative_url }})

请注意，您需要知道页面的永久链接并将其传递给relative_url过滤器，以确保它以网站的基本网址为前缀。

页面的永久链接取决于配置文件中的permalink设置和文件前面的permalink键。

使用jekyll-relative-links

如果你想使用相对路径（并希望链接在GitHub的降价视图中工作），你应该使用jekyll-relative-links。这使您可以编写如下链接：

[Link](./path/to/file.md)

[Link to file in parent folder](../file.md)

Answer 5

如果内部内容位于同一页面上，则可以使用auto_ids功能链接到该页面。您可以在_config.yml中启用此功能：

kramdown:
    auto_ids: true

启用此功能后，每个标题都会根据标题文本获得id引用。例如

### My Funky Heading

将成为

<h3 id="my-funky-heading">My Funky Heading</h3>

您可以通过执行以下操作从同一文档中链接到此文件：

The funky text is [described below](#my-funky-heading)

如果您愿意，可以指定一个显式ID：

### My Funky Heading
{: #funky }

并链接到它

The funky text is [described below](#funky)

Answer 6

想象这是您的项目目录：

要将“ index.md”链接到文件夹“ blog”中名为“ 20190920-post1.md”的文件，请执行以下操作：

1. 打开文件“ index.md”。

2. 添加以下内容：

   [任何文本]（./相对路径）

例如：

- [Sept 20th 2019 - Kikucare's Journey](./blog/20190920-post1.md)

输出：