Text and writing guides

Convert a nested release checklist from bullets to numbered steps and HTML

·

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.

Bullet List Converter

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.

CommonMark rules for list marker widths and nesting

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 &lt;north&gt; and &amp; 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.

WHATWG HTML ordered, unordered and list item elements

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.

Sources

Put it into practice.

Related guides