Using Checklists at Article Boundaries
Using Checklists at Article Boundaries records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.
Use Microsoft Learn checklists at the beginning or end of an article to summarize what readers will learn or have learned, rather than scattering random checklists through the article.
Key details
Important caveats
Scope Boundary
This placement guidance applies to Microsoft Learn’s checklist extension; ordinary lists and task lists in other systems can follow different conventions.
Further guidance
Content
Use Microsoft Learn checklists at the beginning or end of an article to summarize what readers will learn or have learned, rather than scattering random checklists through the article.
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.