simonewebdesign

Hi—I’m Simone Vittori, a software developer based in London. I’m passionate about good software design and I use this blog to write about anything programming related that I find interesting. You can subscribe to the feed or follow my activity on GitHub. Happy reading!

How to Link to Headings in Markdown

27th March 2023

I use Jekyll and I wanted to make all of my headings linkable.

In HTML you can achieve this with a simple link to an element on the same page, except that the link would be self-referencing — for example:

<h2 id="my-heading">
  <a href="#my-heading">My Heading</a>
</h2>

In Markdown, it is equivalent to:

## [My Heading](#my-heading)