# Linking to another page in my documentation

**URL:** <https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352>\
**Category:** Help\
**Created:** [May 4, 2020, 2:54pm UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352 "2020-05-04T14:54:30Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![lmtisme](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/lmtisme/32/2663_2.png) [@lmtisme](https://talk.jekyllrb.com/u/lmtisme)\
**Post date:** [May 4, 2020, 2:54pm UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352/1 "2020-05-04T14:54:30Z")

</div>

Using MkDocs, It was easy to create a link to another page in my documentation. Am I able to do this within jekyll?

I made sure that the link to the new page was an heading. If I am on the page that I want to link to. I can see the address in the URL which is [http://localhost:4000/qms\_reference.html#new-features---add-a-feature-to-qms](http://localhost:4000/qms_reference.html#new-features---add-a-feature-to-qms)

I go to the page that I want to link from and add this:

Add New features to QMS{:target="\_blank"} but I get file not found.

Any help is appreciated.

Thank you.  
Lana

---

<div class="post-metadata">

**Author:** ![michaelbach](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/michaelbach/32/2151_2.png) [@michaelbach](https://talk.jekyllrb.com/u/michaelbach)\
**Post date:** [May 5, 2020, 5:11am UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352/2 "2020-05-05T05:11:30Z")

</div>

I never heard about “MkDocs”, in Jekyll I would try  
`[Add New features to QMS](/qms_reference.html#new-features---add-a-feature-to-qms){:target="_blank"}`  
barring any typos of mine 🙂

---

<div class="post-metadata">

**Author:** ![chmaynard](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/chmaynard/32/2400_2.png) [@chmaynard](https://talk.jekyllrb.com/u/chmaynard)\
**Post date:** [May 8, 2020, 10:24am UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352/3 "2020-05-08T10:24:40Z")

</div>

Try adding this setting to your \_config.yml file:

`permalink: /:title:output_ext`

Now you can link to another page simply using its title. For example, if you want to link to `YYYY-MM-DD-post-title`, you can use this syntax:

`[name of link](post-title)`

This should work locally as well.

---

<div class="post-metadata">

**Author:** ![lmtisme](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/lmtisme/32/2663_2.png) [@lmtisme](https://talk.jekyllrb.com/u/lmtisme)\
**Post date:** [May 8, 2020, 10:59am UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352/4 "2020-05-08T10:59:52Z")

</div>

Thanks Michael. I followed your advice.

---

<div class="post-metadata">

**Author:** ![lmtisme](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/lmtisme/32/2663_2.png) [@lmtisme](https://talk.jekyllrb.com/u/lmtisme)\
**Post date:** [May 8, 2020, 11:00am UTC](https://talk.jekyllrb.com/t/linking-to-another-page-in-my-documentation/4352/5 "2020-05-08T11:00:26Z")

</div>

Thanks for the additional information !!