Continuing the discussion from Added information on Markdown syntax.
When writing a document I found myself wanting to link back to certain sections.
This is how I dealt with it.
Specifically I wanted to make a summary of How Rogue AIs may Arise.
That has for example
Hypothesis 1: Human-level intelligence is possible because brains are biological machines.
and then later
Claim 1: Under hypotheses 1 and 2, an autonomous goal-directed superintelligent AI could be built.
I want to be able to link "hypotheses 1" to 'Hypothesis 1'.
The point the previous post seems to be making is that Heading IDs are in fact automatically generated but there's nothing directly in the docs about it. Indeed any heading (as seen by exporting a note to a HTML page) is created with a kebab-case version of the text:
### Hypothesis 1
<h3 id="hypothesis-1">Hypothesis 1</h3>
Because the ID gets made from the entire heading, to make something useful to refer to you have to reformat the Hypotheses/Definitions to something like:
### Hypothesis 1:
Human-level intelligence is possible because brains are biological machines.
You can then refer to this via
### Claim 1:
Under [hypotheses 1](#hypothesis-1) [and 2](#hypothesis-2), an autonomous goal-directed superintelligent AI could be built.
It would indeed be useful if some more documentation about the automatic heading IDs, or some way to create custom anchor tags could be added.