Using Numbered Lists With All Ones
Using Numbered Lists With All Ones records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.
In Microsoft Learn Markdown, you can write every numbered-list item with `1.` and the published list will render in ascending sequence; manual numbering is also allowed for source readability.
Key details
Important caveats
Scope Boundary
This describes Microsoft Learn Markdown rendering. It does not require all-ones source numbering when a team or tool has a different documented convention.
Further guidance
Content
In Microsoft Learn Markdown, you can write every numbered-list item with `1.` and the published list will render in ascending sequence; manual numbering is also allowed for source readability.
Purpose
Keep Microsoft Learn source readable, accessible, reusable, and predictable while following current contributor-platform conventions.
Sources and evidence
Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.
- Markdown reference for Microsoft Learn — Contributor guide (opens in a new tab)Microsoft · Current Microsoft Learn contributor reference for Markdown authoring, including headings/navigation, conceptual images and icons, includes, lists/checklists, nonlocalized strings, alerts, comments, tables, and other Learn extensions.