Auto completion for links to headings / sections in other files

[gavbarnett]

Proposal

When adding a link to a local file autocomplete should be implemented on section headers. This currently works within files but not across files.

The autocomplete on section would appear only after the "#" was typed.

[link to mysection in myfile](/myfile#mysection)

This is similar to other add-ons that autocomplete functions from other files if those files are included. By virtue of getting to this point below the file could be considered included within the link scope and the section headers listed.

[link to mysection in myfile](/myfile#      )

[yzhang-gh]

We need to somehow unify

vscode-markdown/src/completion.ts

Lines 534 to 537 in 51ed4fb

	} else if (/\[[^\]]*\]\(#[^\)]*$/.test(lineTextBefore)) {
	/* ┌───────────────────────────┐
	│ Anchor tags from headings │
	└───────────────────────────┘ */

and

vscode-markdown/src/completion.ts

Lines 578 to 581 in 51ed4fb

	} else if (/\[[^\]]*?\]\([^\)]*$/.test(lineTextBefore)) {
	/* ┌────────────┐
	│ File paths │
	└────────────┘ */

[Lemmingh]

We have no idea about how target rendering system understands URIs.

There is no uniform practice.

I remember to see similar requests before.

---

IMHO, as an ordinary text editor (not a specialized one), features, of course including path completion, should only work for globally accepted conventions.

An alternative solution is adding another section (ILinkDefinitionProvider) to the plugin draft. But seeing the tight budget that highlight.js faces nowadays, I am hesitant about it. We've got three urgently needed systems (IExportingActionProvider, IHeadingInfoProvider, IMathRenderingProvider) to design.

[yzhang-gh]

I think this feature can be useful (although I don't think it will be done in a near future).

[hellt]

it seems there is an extension that does that - https://marketplace.visualstudio.com/items?itemName=TomasHubelbauer.vscode-markdown-link-suggestions. Maybe that will help?

And I also miss this functionality very much, as cross-file cross-heading links are part of any decent documentation