links between tutorials and reference docs

[Rich-Harris]

good point from @fractalhq, we don't do a good job of connecting the different parts of the docs

[braebo]

I could tackle this one with some <a href="link/to#docs" target="_blank"> wrappers (unless there's a better way to open in new tab w. md) like:

[Rich-Harris]

We actually have the ability to render <a> elements however we like — we can basically add a new link method here alongside code...

learn.svelte.dev/src/lib/server/markdown.js

Lines 32 to 34 in 4114ff1

	marked.use({
	renderer: {
	code: (source, language, current) => {

...and e.g. add _target="blank" to any external links, or even use aliases like [motion]($docs/whatever). That way we can keep the authored markdown neat and tidy. The marked API is a bit chaotic but the details are here: https://marked.js.org/using_pro#renderer

[braebo]

So I've added doc-links to the Svelte and Advanced Svelte sections. Should I hold off on the Kit sections for now and open a PR for what's here?

I added the marked anchor tag bit here:

learn.svelte.dev/src/lib/server/markdown.js

Lines 117 to 128 in 6c1ecdd

	},
	link: (href, title, text) => {
	if (href?.includes('$docs')) {
	const url = href.replace('$', 'https://svelte.dev/');
	return `<a target="_blank" href="${url}">${text}</a>`;
	} else if (href?.includes('$kitdocs')) {
	const url = href.replace('$kit', 'https://kit.svelte.dev/');
	return `<a target="_blank" href="${url}">${text}</a>`;
	}
	return false;
	}