Writing & StyleStyle guide

Avoiding Inline Styling in Headings

Avoiding Inline Styling in Headings records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal grammar rule.

Quick answer

Do not add inline bold, italic, or inline-code styling to headings in Microsoft Learn content; headings already have their own style.

Key details

Core Issueavoiding inline styling in headings
RegisterMicrosoft Learn technical documentation

Important caveats

Scope Boundary

This is a publishing-style rule for Microsoft Learn headings and does not prohibit emphasis inside ordinary body text.

Further guidance

Content

Do not add inline bold, italic, or inline-code styling to headings in Microsoft Learn content; headings already have their own style.

Purpose

Keep programmatic or structural text visually consistent and easier for readers to interpret in Microsoft Learn documentation.

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. Text formatting guidelines — Microsoft Learn Contributor Guide (opens in a new tab)Microsoft · Current Microsoft Learn contributor guidance for Git repository/branch names, code style, package and database names, nonlocalized resource names, fenced code blocks, language tags, headings, and link text.

Related guides

Writing & Style

Avoiding Inline Styling in Link Text

Avoiding Inline Styling in Link Text records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal grammar rule.

Writing & Style

Avoiding Inline HTML in Microsoft Learn

Avoiding Inline HTML in Microsoft Learn records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.

Writing & Style

Avoiding Horizontal Scrollbars in Code Blocks

Avoiding Horizontal Scrollbars in Code Blocks records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal grammar rule.

Writing & Style

Avoiding HTML Tables in Microsoft Learn Markdown

Avoiding HTML Tables in Microsoft Learn Markdown records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.

Writing & Style

Avoiding Lettered Lists in Learn Markdown

Avoiding Lettered Lists in Learn Markdown 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