r/mdhandbook

It's been a bit of a long time coming, but I finally managed to get version 1.5 out with better support for cross document links and support for table of contents. Use of [TOC] as a tag in markdown will produce an auto generated, auto-updating table of contents. If you have other table of contents tag formats, we support every tag format we could find. Oh, and our word export creates an actual word table of contents for that, not just a list of links.

Cross document links was a bit of a hard subject - Obsidian style links are standard, so we support those. GFM slugs are different but "more correct" so we support those as well. Those are both a bit fragile though - if someone comes along and changes a heading name in a document you've linked to then your link gets broken, so we also support ID based heading links. That does need you to write the id to the end of the heading, which possibly involves updating the other file to add a heading, but it's worth it to keep references stable in codebase documentation. You can pick the model you prefer.

Outside of that, the back and forward navigation needed to get smarter and take you to the right scroll position in the target document. That was a pig as there's a lot at play with document dynamic loading, but hopefully you'll find it's all working pretty smoothly now.

The usual general quality of life updates too - users reported loss of selection highlight so that's fixed along with some other issues and bug fixes. All in the release notes. Starting to get close to where I envisioned the "base" functionality being!