Markdown Toolbox Logo Markdown Toolbox
Home
Blog

How to use subbullets in Markdown?

2024-10-07

Short version

Use indentation (spaces or tabs) under a list item to create subbullets.

* Main bullet
    * Sub bullet
  • Main bullet
    • Sub bullet

Long version

Introduction

Creating subbullets in Markdown can help to organize lists and improve readability. This guide outlines the syntax and best practices for using subbullets effectively.


1. Creating a Basic List

To create a bullet list, use *, -, or + followed by a space:

* Item 1
* Item 2
* Item 3

2. Adding Subbullets

To add subbullets, indent your sublist under the main bullet. Example:

* Item 1
    * Subitem 1a
    * Subitem 1b
* Item 2

This will be rendered as:

  • Item 1
    • Subitem 1a
    • Subitem 1b
  • Item 2

3. Best Practices

  • Maintain consistent indentation (although Markdown parsers can vary in handling spaces or tabs).
  • Use a clear hierarchy for improved readability.

Conclusion

Subbullets are a powerful tool to organize content in Markdown. Use them judiciously to enhance clarity in your documents.