jekyll markdown内部链接

Jekyll使用Markdown格式的链接,但是如何链接到内部内容?

[[link]] 

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

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

这也在Jekyll文档中被引用。

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

对于页面, 他们决定不添加page_url标签,因为无论如何你必须知道页面的path。 所以你只需要手动链接到它:

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

或者,如果你想以编程方式获得页面的标题,你可以做这样一个大而难看的东西:

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

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

 {{ 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标记时包含文件扩展名。 用它来创build一个链接:

 [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文档 。

在Jekyll中有多种连接方式,其中一些现在已经过时。

带有链接标签

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

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

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

永久链接

链接到一个页面而不会导致错误(改为断开的链接):

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

请注意,在这里您需要知道页面的固定链接,并通过relative_urlfilter将其传递,以确保它以该网站的基本url为前缀。

一个页面的permalink取决于你的configuration文件中的permalink设置和文件前端的permalink

与jekyll相关链接

如果你想使用相对path(并希望链接在GitHub的markdown视图中工作),你应该使用jekyll-relative-links 。 这可以让你写下如下链接:

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