Making internal links within a page.
So, you can make internal link with Markdown. These are links that allow you to jump within the page using titles. It's useful for making a chapter list for really long posts, for exemple.
I learned this in the making of the French translation of the Bearblog docs. And it was a pain in the ass to figure out to the point where, I'm pretty sure there are some broken ones still left in there but I finally figured it out.
So let's make an exemple.
Title 1. Nothing special.
Lorem ipsum odor amet, consectetuer adipiscing elit. Facilisis quis imperdiet massa pellentesque orci? Auctor interdum mauris interdum ante pretium fusce dui ante. Curabitur ridiculus quis lacinia turpis habitasse a litora.
Elementum leo libero dictum neque sodales massa senectus mattis. Senectus enim enim cursus potenti vehicula taciti ex. Maximus vehicula ipsum, senectus turpis purus condimentum egestas. Per lacus facilisis penatibus ultricies porttitor commodo nullam ex eget. Platea pretium ipsum odio sodales turpis per felis; litora consectetur. Sed proin feugiat eros est maecenas ridiculus orci tristique.
At ridiculus faucibus facilisis cras himenaeos curabitur. Finibus quam at ornare at potenti. Penatibus pharetra maecenas id conubia gravida; et porta dis semper. Nisl dis maximus tortor nam morbi convallis potenti!
Title 2. This one has an annoying character like ç.
Donec eros dapibus dis ex; elementum enim? Habitasse hac tristique rutrum maecenas hendrerit diam. Feugiat habitasse ad litora semper bibendum amet platea auctor. Elementum habitasse suspendisse neque metus netus fusce. Semper neque quam eget condimentum blandit nulla nulla.
Sem tristique eget tristique ornare a eros. Pharetra inceptos consequat quisque gravida maximus pellentesque integer massa. Aliquam primis varius nisi eleifend quam senectus. Anisl dictumst nascetur integer ut massa, finibus vitae.
Lobortis netus aliquet porta est class, magna lobortis ad. Mauris mi ridiculus justo dui suscipit ligula. Morbi est pulvinar fames scelerisque sem adipiscing cras morbi fringilla.
Title 3. Just a title.
Tempus nisi hac quam scelerisque massa, euismod primis. Vivamus luctus habitasse eleifend id diam porta.
Nulla posuere dolor maximus luctus ligula amet platea magna. Dis finibus aptent ligula scelerisque justo eleifend vitae a. Leo justo habitant, enim ridiculus interdum ullamcorper massa. Commodo conubia quam mi class dolor curabitur purus.
Parturient fringilla ad; efficitur sed parturient in morbi. Lectus rutrum bibendum duis netus mus lorem elementum magna. Vestibulum auctor tellus integer sodales netus aptent aptent risus.
Pulvinar cubilia fermentum dictum congue nascetur metus. Orci iaculis odio massa consequat vehicula tincidunt. Torquent mi ullamcorper torquent sollicitudin auctor phasellus est donec porttitor. Vel montes fermentum maecenas aliquet accumsan mus elit. Arcu finibus donec facilisis ridiculus senectus luctus mauris maximus a. Eu curae inceptos dignissim ornare ante fringilla dapibus.
Ok. So, I made the title have different sizes on purpose because it doesn't matter! I used to think it did.
To jump to title one, all you need to do is make a normal link but type a # followed by the exact title with dashes for spaces where the link would go. So, jump to title one, it would look like this:
[Jump to title one.](#title-1-nothing-special)
In practice, it should look like this: Jump to title one.
Note that I didn't take in to accounts the ponctuation, it's the same with special characters. So for title two, it'd look like this.
[Jump to title two.](#title-2-this-one-has-an-annoying-character-like-c)
Which in practice, does this: Jump to title two.
Special characters like ç can be annoying to figure out but here, c works fine as a supplement. Try things out before posting, just in case.
So, here's a chapter list.
- [Chapter 1.](#title-1-nothing-special)
- [Chapter 2.](#title-2-this-one-has-an-annoying-character-like-c)
- [Chapter 3.](#title-3-just-a-title)
Which again, in practice, looks like this: