Change the ID Prefix and Separator
When an AsciiDoc processor auto-generates section IDs, it begins the value with an underscore and uses a hyphen between each word.
These characters can be customized with the
By default, the AsciiDoc processor begins an auto-generated section ID with an underscore (
This default can cause problems when using it as an xref target in AsciiDoc.
The leading underscore may get paired with an underscore somewhere else in the paragraph, thus resulting in unexpected text formatting.
That’s why we strongly encourage you to customize the ID prefix.
You can change this prefix by setting the
idprefix attribute and assigning it a new value.
The value of
idprefix must begin with a valid ID start character and can have any number of additional valid ID characters.
If you want to remove the prefix, set the attribute to an empty value.
If you set the
The default section ID word separator is an underscore (
You can change the separator with the
Unless empty, the value of the
idseparator must be exactly one valid ID character.
If you don’t want to use a separator, set the attribute to an empty value.
When a document is rendered on GitHub, the