# How to create anchor tag markdown in Postman?

**URL:** <https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276>\
**Category:** Help Hub\
**Created:** [March 21, 2018, 2:25pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276 "2018-03-21T14:25:28Z")\
**Posts on this page:** 16\
**Page:** 1

<div class="post-metadata">

**Author:** ![jonath23](https://avatars.discourse-cdn.com/v4/letter/j/6bbea6/32.png) [@jonath23](https://community.postman.com/u/jonath23)\
**Post date:** [March 21, 2018, 2:25pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/1 "2018-03-21T14:25:28Z")

</div>

No matter what I tried, none of the following work:  
Some heading  
 Some heading

 
Some heading Some heading Some heading

all these options omit the name or id in the html

---

<div class="post-metadata">

**Author:** ![kunagpal](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/kunagpal/32/9_2.png) [@kunagpal](https://community.postman.com/u/kunagpal)\
**Post date:** [March 21, 2018, 2:35pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/2 "2018-03-21T14:35:16Z")

</div>

Hey @jonath23, I was able to get it working as follows:  
Markup variant:

```auto
<a href="https://www.getpostman.com">Markup Anchor</a>

```

Markdown variant

```auto
[Markdown Anchor](https://www.getpostman.com)

```

---

<div class="post-metadata">

**Author:** ![jonath23](https://avatars.discourse-cdn.com/v4/letter/j/6bbea6/32.png) [@jonath23](https://community.postman.com/u/jonath23)\
**Post date:** [March 21, 2018, 2:49pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/3 "2018-03-21T14:49:46Z")

</div>

Hi Kunagpal,  
I’m talking about anchor link for an area in the same page.

---

<div class="post-metadata">

**Author:** ![kunagpal](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/kunagpal/32/9_2.png) [@kunagpal](https://community.postman.com/u/kunagpal)\
**Post date:** [March 21, 2018, 4:08pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/4 "2018-03-21T16:08:48Z")

</div>

Yes, the above snippets should work fine if the link has an id # suffix as well.

---

<div class="post-metadata">

**Author:** ![jonath23](https://avatars.discourse-cdn.com/v4/letter/j/6bbea6/32.png) [@jonath23](https://community.postman.com/u/jonath23)\
**Post date:** [March 22, 2018, 3:05pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/6 "2018-03-22T15:05:47Z")

</div>

Okay, I don’t think we understand each other. I’m trying to create an anchor to reference to another part in the SAME page . While the ref works as expected, name seems to be omitted and so href links no where. Can you please tell me what I’m doing wrong?  
Thank you.

---

<div class="post-metadata">

**Author:** ![jetison](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/jetison/32/12_2.png) [@jetison](https://community.postman.com/u/jetison)\
**Post date:** [April 4, 2018, 6:22pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/7 "2018-04-04T18:22:13Z")

</div>

@jonath23 to clarify, currently you can’t CREATE an anchor manually using the `name` attribute.

As @kunagpal said, you can link to existing spots within a page where an `id` already exists (e.g. headers in the intro, folders, and requests).

---

<div class="post-metadata">

**Author:** ![jonath23](https://avatars.discourse-cdn.com/v4/letter/j/6bbea6/32.png) [@jonath23](https://community.postman.com/u/jonath23)\
**Post date:** [April 9, 2018, 12:59pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/8 "2018-04-09T12:59:03Z")

</div>

Hey Joyce,  
I appreciate the elaborate answer, yet I’m a little confused. Let me explain my issue first. I’m required to have links from one API to another. For example, in an API such as ‘get by Id’, I’m required to have an anchor link to ‘get all’ with an explanation that the required Id could be found there. How can I create that link?  
Thank you,  
Yoni

---

<div class="post-metadata">

**Author:** ![godfrzerp](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/godfrzerp/32/11_2.png) [@godfrzerp](https://community.postman.com/u/godfrzerp)\
**Post date:** [April 9, 2018, 3:12pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/9 "2018-04-09T15:12:48Z")

</div>

At this time, you can link to these parts within generated documentation:

- Introduction header
- Request
- Folder
- Response

The links are generated using IDs for the requests, folders and responses. If you click on any of these, the URL in your browser should update to a link which points to this specific part of the documentation. You can link to these parts using this link.

As @jetison and @kunagpal mentioned, it’s not possible to link to _any_ arbitrary part of the documentation.

If you’d like the ability to link to any point, please create an issue to track this feature request on GitHub [here](https://github.com/postmanlabs/postman-app-support/issues).

---

<div class="post-metadata">

**Author:** ![lifewingmate](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/lifewingmate/32/326_2.png) [@lifewingmate](https://community.postman.com/u/lifewingmate)\
**Post date:** [June 12, 2018, 11:59pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/10 "2018-06-12T23:59:24Z")

</div>

Is it a known issue that none of the links in doc are showing? The functionality works, but you cannot see them at all. If you hover over it and look to the bottom left of the browser, you can see what the hyperlink is linking to and even land on the intended page.

So, for example,  
**Markdown**  
“For information about each of the field types that returns from the metadata, see the  
[Metadata Reference]  
([https://documenter.getpostman.com/view/4108327/RVu7ETjY#2fc7db2d-5ee9-46cb-aa3b-303f1a29df96](https://documenter.getpostman.com/view/4108327/RVu7ETjY#2fc7db2d-5ee9-46cb-aa3b-303f1a29df96) “Metadata Reference”).”

**Output**  
Completely blank. But, when you hover on the bottom left, you see this specific link [https://documenter.getpostman.com/view/4108327/RVu7ETjY#2fc7db2d-5ee9-46cb-aa3b-303f1a29df96](https://documenter.getpostman.com/view/4108327/RVu7ETjY#2fc7db2d-5ee9-46cb-aa3b-303f1a29df96) and you can go to the spot in the same doc.

Is there a workaround perhaps? Thanks!

---

<div class="post-metadata">

**Author:** ![lifewingmate](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/lifewingmate/32/326_2.png) [@lifewingmate](https://community.postman.com/u/lifewingmate)\
**Post date:** [June 13, 2018, 4:02pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/11 "2018-06-13T16:02:12Z")

</div>

Hi there @godfrzerp I’ve been testing this issue out to see if the Markdown is the issue or not. It appears that any links of the 4 types mentions are also not showing up in the generated documentation. I tested the display on Chrome, Firefox, and Edge. Here are additional examples when comparing the editor and the output.

One of the lead developers I talked to examined this issue further and it looks like there is a CSS issue turning any links into white text even if you add markdown or html elements around it (such as code tags). Are any other customers experiencing this issue and can you advise how to fix this?

 ![2018June13markdown_result_example_Postmanapp](https://us1.discourse-cdn.com/getpostman/original/3X/3/1/310f138369d7bb9de2f4b5af712c39a7c776877a.png)

---

<div class="post-metadata">

**Author:** ![godfrzerp](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/godfrzerp/32/11_2.png) [@godfrzerp](https://community.postman.com/u/godfrzerp)\
**Post date:** [June 27, 2018, 8:32am UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/12 "2018-06-27T08:32:55Z")

</div>

^ If anyone else is running into this issue: The links, icons, etc. within your public documentation will use the “highlight” color specified while publishing.

---

<div class="post-metadata">

**Author:** ![xxxargonxxx](https://avatars.discourse-cdn.com/v4/letter/x/cab0a1/32.png) [@xxxargonxxx](https://community.postman.com/u/xxxargonxxx)\
**Post date:** [December 26, 2018, 2:09pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/13 "2018-12-26T14:09:52Z")

</div>

@godfrzerp following your advice to use the auto-generated Ids of API methods, folders and other things… This means that these Ids can be treated as constants and will not change over time. So, is it correct assumption? Can I rely on these Ids and be sure that they wont change?

---

<div class="post-metadata">

**Author:** ![godfrzerp](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/godfrzerp/32/11_2.png) [@godfrzerp](https://community.postman.com/u/godfrzerp)\
**Post date:** [December 26, 2018, 4:57pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/14 "2018-12-26T16:57:22Z")

</div>

Yes, IDs are preserved in all cases except destructive ones. For example, a request will keep it’s ID until it is destroyed (deleted, transferred, etc.).

---

<div class="post-metadata">

**Author:** ![tjmcdonough20](https://avatars.discourse-cdn.com/v4/letter/t/ed655f/32.png) [@tjmcdonough20](https://community.postman.com/u/tjmcdonough20)\
**Post date:** [August 27, 2021, 2:19pm UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/15 "2021-08-27T14:19:05Z")

</div>

You just need to name a heading. For example

# Product Object

then create a link like below  
`[Product Object](#product-object)`

---

<div class="post-metadata">

**Author:** ![Dimkanp](https://avatars.discourse-cdn.com/v4/letter/d/258eb7/32.png) [@Dimkanp](https://community.postman.com/u/Dimkanp)\
**Post date:** [August 31, 2021, 10:48am UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/16 "2021-08-31T10:48:17Z")

</div>

Thank you! Your answer helped me incredibly much!

---

<div class="post-metadata">

**Author:** ![docking-module-archi](https://avatars.discourse-cdn.com/v4/letter/d/b5a626/32.png) [@docking-module-archi](https://community.postman.com/u/docking-module-archi)\
**Post date:** [July 27, 2023, 11:04am UTC](https://community.postman.com/t/how-to-create-anchor-tag-markdown-in-postman/1276/17 "2023-07-27T11:04:41Z")

</div>

Hello …  
I am now writing this markdown in postman documentation, most of times, my anchor link always change to be “null”, event though it worked previously, then it will just become null after editing it.  
#Anchor-Documentation
