Skip to main content

Add Content Inside a List Item or Step

When you are writing lists and procedures, it is likely that you will need to add some extra content inside the step. This could be an extra paragraph, an image, or an admonition. In this article, we will explain how to do that. If you are looking for help on how to have a sublist inside another list, see Sublists.

To add content inside a list item or step:

  1. Position the cursor so that it is outside the para element in the list item or step. (But still inside the list item or step).

    Image showing a topic with a procedure in it. The cursor is positioned after the paragraph element in a step, but still inside the step. A callout arrow points to the position. Also, there is a callout box on the element structure menu to show that the currently selected position is still inside the step element of the procedure.

  2. You can now add other elements, such as images, admonitions, and other paragraphs. To add these, you can use the toolbar menu or the element context menu, just like when you add elements outside a list. The elements that you add will appear indented, so that they are aligned with the paragraph inside the list item or step.

    Note

    To access the element context menu, press Alt and Enter (Windows) or Option ⌥ and Enter (Mac).

  3. To add a list item or step after the content inside the step, position the cursor so that it is outside the list item or step. Then press Enter to display the element context menu and select listitem or step, depending on the type of list you are using.

    Topic showing a procedure. A step is being added after a paragraph that is inside the previous step. The cursor is positioned after the previous step element and a context menu is shown. A callout arrow is pointing to the menu which has a Step option. At the top, a callout box shows that the cursor's current position is inside the procedure element, but not inside a step element.

  4. To end the list, select a position outside the list, after the last step. You can then add other elements, such as paragraphs if needed.