Writing & StyleStyle guide

Formatting AI Prompts in Technical Documentation

Formatting AI Prompts in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Quick answer

Use quotation marks when referring to AI prompts in running text in Microsoft-style developer documentation; if a list introduction already identifies the items as prompts, special formatting is not necessary.

Key details

Core IssueUse quotation marks when referring to AI prompts in running text in Microsoft-style developer documentation; if a list introduction already identifies the items as prompts, special formatting is not necessary.
RegisterMicrosoft technical and professional documentation

Important caveats

Scope Boundary

This is a Microsoft developer-content convention for referring to prompt text; it does not prescribe prompt-engineering syntax or universal quotation rules.

Further guidance

Content

Use quotation marks when referring to AI prompts in running text in Microsoft-style developer documentation; if a list introduction already identifies the items as prompts, special formatting is not necessary.

Purpose

Help readers distinguish the literal technical element from surrounding explanatory prose.

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. Formatting developer text elements — Microsoft Style Guide (opens in a new tab)Microsoft · Microsoft Style Guide conventions for formatting programmatic and code-related elements in developer content.

Related guides

Writing & Style

Formatting Attributes in Technical Documentation

Formatting Attributes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Classes in Technical Documentation

Formatting Classes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Code Keywords in Technical Documentation

Formatting Code Keywords in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Code Samples in Technical Documentation

Formatting Code Samples in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it scoped to technical instructions rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Constants in Technical Documentation

Formatting Constants in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Control Classes in Technical Documentation

Formatting Control Classes in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Data Formats in Technical Documentation

Formatting Data Formats in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Writing & Style

Formatting Data Types in Technical Documentation

Formatting Data Types in Technical Documentation records a distinct Microsoft Style Guide authoring convention and keeps it explicitly scoped to technical documentation rather than presenting it as a universal grammar rule.

Explore the topic