Markdown Definition List
How to create definition lists in markdown for glossaries, dictionaries, and term-definition pairs.
What is markdown definition list?
Definition lists pair terms with their definitions, similar to a dictionary. In extended markdown (PHP Markdown Extra, Pandoc), a term on one line followed by a colon and definition on the next line creates a definition list (<dl>, <dt>, <dd>). Not part of CommonMark.
Syntax
Basic definition
Term on its own line, definition on the next starting with :
- Markdown
- A lightweight markup language for creating formatted text.
Multiple definitions
A term can have multiple definitions by adding multiple : lines.
- API
- Application Programming Interface
- A set of rules...
Platform support
| Platform | Supported | Notes |
|---|---|---|
| GitHub | No | Not supported in GFM — use a table instead |
| GitLab | No | — |
| Pandoc | Yes | — |
| PHP Markdown Extra | Yes | — |
| Obsidian | No | — |
| Discord | No | — |
Common mistakes
Using on GitHub (not supported)
Use a two-column table for term/definition pairs on GitHub
GitHub does not support definition list syntax. Use | Term | Definition | table syntax instead.
Tips for definition list
On platforms without definition list support, a two-column markdown table with Term | Definition headers achieves the same visual result.
Frequently asked questions
Everything you need to know.
How do I create a definition list in markdown?
In extended markdown parsers (Pandoc, PHP Markdown Extra): put the term on its own line, then the definition on the next line starting with a colon. GitHub does not support this — use a table instead.
Related elements
Table
Markdown tables use pipes (|) and hyphens (-) to create rows and columns. The second row defines column alignment with colons. Tables are ideal for structured data, comparisons, and reference material.
Bullet List
Bullet lists (unordered lists) in markdown start each item with a dash (-), asterisk (*), or plus sign (+) followed by a space. They're the most common way to present non-sequential items, features, or options.
Numbered List
Numbered lists (ordered lists) in markdown start each item with a number followed by a period and a space (1. ). Markdown auto-numbers the output regardless of the numbers you type — all items could be "1." and the rendered list would still count correctly.
Try it in the editor
Paste your markdown and see definition list rendered instantly with professional themes.