Writing & StyleStyle guide

Requiring a Space After Learn Heading Hashes

Requiring a Space After Learn Heading Hashes 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 Microsoft Learn Markdown, put a space between the final `#` heading marker and the heading text.

Key details

Core Issuerequiring a space after learn heading hashes
RegisterMicrosoft Learn technical documentation

Important caveats

Scope Boundary

This is a Microsoft Learn Markdown requirement. Do not generalize it to unrelated syntaxes that use different heading markers.

Further guidance

Content

Write Learn headings with a space after the last `#`, such as `## Heading`, because the contributor reference requires that separation.

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.

Explore the topic