We shouldn't link to unpublished pages.
Keep a list of target anchors rather than just one (arbitrary).

We can then pick the best anchor when applying links, based on
current context (ie current page or subsection we are in while parsing).

Not done yet and probably difficult unless header of current section
== optional context.
Better logging output if element is already in a code block.
Log if a keyword could link to multiple locations.

By default, pick the first - pages with the keyword as title are prioritized
over sections within a page.

To silence those warnings, make explicit links to the right target.
Pick best link target for promise type attributes based on current type.

Calculate a score for each link alternative when generating links from syntax map.