- Type: `boolean`

- Accepts: `true|false`

- Default: `false`

Changes the syntax for the select options from `--` or `~~` to appending the an HTML comment (`<!-- select-option -->`) to the heading. For example:

<!-- select:start -->

<!-- select-menu-labels:Operating System -->

#### macOS <!-- select-option -->

macOS instructions here

#### Linux <!-- select-option -->

Linux instructions here

#### Windows <!-- select-option -->

Windows instructions here

<!-- select:end -->

**Configuration**

window.$docsify = {

// ...

select: {

useSelectHeadingComment: false, // default

},

};

selectHeadingMarkup: /[\r\n]*(\s*)#{1,6}\s*[~-]{2}\s*(.*[^\s])\s*[~-]{2}[\r\n]+([\s\S]*?)(?=#{1,6}\s*[~-]{2}|<!-+\s+select:\s*?end\s+-+>)/m,

// Matches select option and content

// 0: Match

// 1: Option: #### Label <!-- selection-option -->

// 2: Content

selectHeadingComment: /[\r\n]*(\s*)#{1,6}\s*(.*?)\s*<!-+\s+select-option\s+-+>[\r\n]+([\s\S]*?)(?=#{1,6}\s*[^\r\n]*<!-+\s+select-option\s+-+>|<!-+\s+select:\s*?end\s+-+>)/m

useSelectHeadingComment: false,

if (settings.useSelectHeadingComment) {

// Swap these around. Kind of dirty doing it this way.

regex.selectHeadingMarkup = regex.selectHeadingComment;

}