Writing & StyleStyle guide

Indenting Learn Numbered-List Continuations by Three Spaces

Indenting Learn Numbered-List Continuations by Three Spaces records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.

Quick answer

In the Microsoft Learn numbered-list pattern that uses `1. ` markers, indent continuation text and code three spaces so they align with the list item.

Key details

Core Issueindenting learn numbered-list continuations by three spaces
RegisterMicrosoft Learn technical documentation

Important caveats

Scope Boundary

This is the Microsoft Learn example for `1. ` list markers. Other Markdown systems or different marker widths can have different indentation behavior.

Further guidance

Content

For a Learn numbered-list item written with `1. `, the contributor reference shows following paragraph and code lines indented three spaces to align under the item text.

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.

  1. 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.

Related guides

Writing & Style

Indenting Learn Bullet Continuations by Two Spaces

Indenting Learn Bullet Continuations by Two Spaces records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.

Explore the topic