# Heading anchors not being created

**URL:** <https://discuss.write.as/t/heading-anchors-not-being-created/19533>\
**Category:** Help\
**Tags:** troubleshooting, writeas\
**Created:** [September 13, 2025, 10:36am UTC](https://discuss.write.as/t/heading-anchors-not-being-created/19533 "2025-09-13T10:36:14Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![kavm](https://discuss.write.as/letter_avatar_proxy/v4/letter/k/3ec8ea/32.png) [@kavm](https://discuss.write.as/u/kavm)\
**Post date:** [September 13, 2025, 10:36am UTC](https://discuss.write.as/t/heading-anchors-not-being-created/19533/1 "2025-09-13T10:36:14Z")

</div>

Hello,

I’m a paid Write.as subscriber and I’ve tried to use the instructions in this post to link to section headings indicated with `#`, `##`, etc. from else where in my posts:

> [@In-post anchors](https://discuss.write.as/t/in-post-anchors/468/2):
>
> Anchor links are supported in markdown and work on write.as/writefreely. Here’s 2 references: [https://justin.kelly.org.au/anchor-links-in-markdown/](https://justin.kelly.org.au/anchor-links-in-markdown/)

For example, if I have a heading like this:

```auto
## This is a heading

```

And I would create links to it elsewhere in my post with:

```auto
[link to the heading](#This-is-a-heading)

```

Indeed “link to the heading” is created as a link in my published post to the post URL followed by `#This-is-a-heading`, but when I click on it, it _doesn’t_ take me to the heading!

Instead, I have to manually create an anchor by prepending this to my actual heading (which is described [here](https://discuss.write.as/t/adding-an-anchor-to-a-document/8390/2) and [here](https://justin.kelly.org.au/anchor-links-in-markdown/)):

```auto
## <a id="This-is-a-heading"></a> This is a heading

```

Now, my “link to the heading” link in the post would take me to that heading.

This works but is cumbersome and brittle.

Are headings not automatically parsed and created a linkable anchors by Write.as? Or am I doing something wrong?

Thanks in advance for your detailed response! 🙏

---

<div class="post-metadata">

**Author:** ![matt](https://discuss.write.as/user_avatar/discuss.write.as/matt/32/2760_2.png) [@matt](https://discuss.write.as/u/matt)\
**Post date:** [September 23, 2025, 8:10pm UTC](https://discuss.write.as/t/heading-anchors-not-being-created/19533/2 "2025-09-23T20:10:19Z")

</div>

Hi, we do automatically generate heading IDs so they can be linked like this! You can confirm by viewing the source of your post, where you should see `id="this-is-a-heading"` on each heading tag.

However, these IDs are generated in all lowercase, so that might be the issue here. If you use the lowercase, does it work for you? E.g.

```markdown
[link to the heading](#this-is-a-heading)

```

---

<div class="post-metadata">

**Author:** ![kavm](https://discuss.write.as/letter_avatar_proxy/v4/letter/k/3ec8ea/32.png) [@kavm](https://discuss.write.as/u/kavm)\
**Post date:** [September 24, 2025, 8:10pm UTC](https://discuss.write.as/t/heading-anchors-not-being-created/19533/3 "2025-09-24T20:10:53Z")

</div>

> [@matt](#):
>
> However, these IDs are generated in all lowercase, so that might be the issue here.

Aha, that’s it! I had headings with capital letters, and didn’t know they’d be converted to all lowercase in the IDs.

Thank you so much @matt! ❤ 🙏

Is this documented somewhere?