For regular markdown files (.md), VSCode's IntelliSense autocomplete can support a very critical everyday authoring use case for docsite content: links that reference headers in the same file, and occasionally also links that reference a specific header in another file. It's dirt easy in VSCode to type # inside empty link destination delimiters (), and IntelliSense will display a handy list of all headers in the current .md file. Likewise, you can type ## and IntelliSense will display a handy list of ALL headers in ALL .md files, which you can quickly filter down with typeahead.

I cannot overstate how significant this authoring shortcut can be. It's a massive time-saver when you're maintaining large doc sites.

Unfortunately, the MDX extension for VSCode does not support this type of link path completion as of November 2024. The MDX extension supports relative file path completion (using ./ or ../), but it doesn't support link path completion (using # or ##).

Do you have a roadmap item to improve your IntelliSense functionality in the MDX extension to support this type of autocomplete shortcut for .mdx files in VSCode? If not, I would suggest that you prioritize this usability gap.