By default, all cross references 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
--split-headers, cross references such as
The same applies to cross file references when there are multiple input files.
- from the non-split
hello.htmlto the section in the current non-split file
- from split
hello-split.htmlto the same section in non-split file with
In order to make the split version be the default for some headers, you can use the
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.