Convert a nested release checklist from bullets to numbered steps and HTML
Admin ·
Choose a marker format for the place where the checklist will be read. A plain text handoff can use visible numbers, while a web page benefits from list elements that express the order and nesting.
Continue the release checklist at step 7
Load the example, choose Numbered text and set Start number to 7. Keep Preserve nesting on. The first and last top-level items are 7 and 8. The two indented checks below the first item are 1 and 2.
Turn Preserve nesting off. The same text has four top-level steps, numbered 7 through 10. Enable nesting again if the two checks belong under the first step.
Check the HTML nesting and literal angle brackets
Choose HTML ordered list and leave the start at 7. Add release-checklist to List class if your site has a matching style. The source begins with an ol element whose start attribute is 7. Look for a second ol inside the first li.
Open the downloaded HTML in a browser. The second-level item should display Review <north> panel, and the first line should display an ampersand. The source has <north> and & so those characters are written as text.
WHATWG HTML ordered, unordered and list item elementsWHATWG HTML fragment serialization and escaping
Use unordered HTML when item order can change
Switch to HTML unordered list if each item can be completed in any order. The markup uses ul elements. The number style and starting number controls apply to ordered output.
For a plain text round trip, use Swap text direction after choosing numbered text. It loads the current result and switches to bullets. Restore the original text if you want to keep its previous marker styles.
Common questions
Can I apply a class name without changing list numbering?
Yes. The class is a CSS hook and can be used with ordered or unordered HTML. Start number and HTML numbering style are independent controls.
How do I check nesting after pasting into a Markdown editor?
Use its rendered preview. CommonMark calculates nesting from the width of the parent marker and spaces that follow it. The plain text modes retain your input indentation, so a wider marker can require additional spaces in that editor.