OurBigBook Docs
By default, all internal links point to the non-split version of headers, including those found in split headers.
The rationale for this is that it gives readers the most context around the header by simply scrolling.
For example, considering the example document at The same applies to cross file internal links when there are multiple input files.
-S, --split-headers, internal links such as \x[h1-1] would point:- from the non-split
hello.htmlto the section in the current non-split file#h1-1 - from split
hello-split.htmlto the same section in non-split file withhello.html#h1-1
In order to make the split version be the default for some headers, you can use the
\H splitDefault argument.This is something that we might consider changing with some option, e.g. keeping the split headers more self contained. But for now, the general feeling is that going to nosplit by default is the best default.