Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Emphasis Rules

Rules for formatting bold and italic text.

Rules in This Category

RuleDescriptionAuto-fix
MD036Emphasis used instead of headingNo
MD037Spaces inside emphasis markersYes
MD049Emphasis style consistencyYes
MD050Strong emphasis style consistencyYes

Overview

Emphasis rules ensure consistent formatting of bold (**text**) and italic (*text*) text throughout your documents.

Common Issues

  • Using **bold** on a line by itself as a pseudo-heading

  • Spaces inside markers like **bold** that may not render

  • Mixing asterisks and underscores inconsistently

Best Practices

  • Use real headings (##) instead of bold text for sections
  • Keep emphasis markers tight against text (no internal spaces)
  • Choose one style (asterisks or underscores) and use it consistently