Skip to content

Emphasis Syntax

Emphasis syntax is used to highlight text and is one of the most commonly used formatting features in Markdown. By using different emphasis methods, you can make important content stand out.

Basic Emphasis Syntax

Italic

Use a single asterisk * or underscore _ to wrap text:

markdown
*italic text*
_italic text_

Rendered Output:italic textitalic text

Bold

Use double asterisks ** or double underscores __ to wrap text:

markdown
**bold text**
__bold text__

Rendered Output:bold textbold text

Bold and Italic

Use three asterisks *** or three underscores ___, or mix them:

markdown
***bold italic text***
___bold italic text___
**_bold italic text_**
*__bold italic text__*

Rendered Output:bold italic textbold italic textbold italic textbold italic text

Syntax Selection Advice

Asterisk vs Underscore

SymbolAdvantageDisadvantageRecommended Scenario
*More common, better compatibilityMay be confused with lists in some editorsGenerally recommended
_Clearer inside wordsLess used, may be unfamiliarSpecial cases
markdown
✅ Recommended: Stay consistent
Here is **bold** and *italic* text.

❌ Not recommended: Mixed usage
Here is **bold** and _italic_ text.

Using Emphasis Inside Words

Limitation of Asterisk

Asterisks may not be recognized inside words:

markdown
love*is*beautiful  ← may not render as italic

Advantage of Underscore

Underscores are more reliable inside words:

markdown
love_is_beautiful  ← more likely to render correctly

Tip: If you need emphasis inside words, prefer underscores.

Nested Emphasis

Basic Nesting

You can nest italic inside bold, or bold inside italic:

markdown
**This is bold with *italic* text inside**
*This is italic with **bold** text inside*

Rendered Output:This is bold with italic text insideThis is italic with bold text inside

Complex Nesting

markdown
***This is bold italic with normal text***
**Bold paragraph with *italic clause* and normal text**
*Italic paragraph with **bold keyword** and normal text*

Rendered Output:This is bold italic with normal textBold paragraph with italic clause and normal textItalic paragraph with bold keyword and normal text

Common Errors and Solutions

1. Mismatched Symbols

markdown
❌ Incorrect:
*This is unclosed italic
**This is mismatched bold*

✅ Correct:
*This is correct italic*
**This is correct bold**

2. Space Issues

markdown
❌ Incorrect:
* this is not italic *
** this is not bold **

✅ Correct:
*this is italic*
**this is bold**

3. Characters Around Symbols

markdown
❌ Potential issue:
Text*italic*text  ← may not render

✅ Safer:
Text *italic* text
Text_italic_text

Special Cases

Escaping Emphasis Symbols

If you need to display asterisks or underscores themselves, use a backslash to escape:

markdown
\*this is not italic\*
\**this is not bold\**
\_this is not italic\_

Rendered Output: *this is not italic* *this is not bold* _this is not italic_

In Code

In inline code, emphasis symbols are displayed literally:

markdown
`*the asterisk here will not be interpreted as italic*`
`**the double asterisks here will not be interpreted as bold**`

Rendered Output:*the asterisk here will not be interpreted as italic***the double asterisks here will not be interpreted as bold**

Semantic Usage

Semantic Uses of Italic

  • Emphasis: This is important
  • Foreign words: Hello World
  • Terms: HTTP protocol
  • Citations: As stated in "Romance of the Three Kingdoms"
  • Variables: Set x to 10

Semantic Uses of Bold

  • Importance: Pay attention to safety
  • Keywords: API endpoint
  • Warning: Do not delete important files
  • Subheadings: Step One: Install the software

Uses of Bold Italic

  • Extremely important: Never do this
  • Strong recommendation: Highly recommended to read the documentation

Best Practices

1. Use Moderately

markdown
✅ Recommended: Moderate emphasis
This feature is **very important**, please read the documentation carefully.

❌ Not recommended: Over-emphasis
**This feature*****is very important***,**please read****the documentation**.

2. Stay Consistent

markdown
✅ Recommended: Always use asterisks
Use **bold** and *italic* to emphasize content.

❌ Not recommended: Mixed symbols
Use **bold** and _italic_ to emphasize content.

3. Use Semantically

markdown
✅ Recommended: Meaningful emphasis
The function returns **true** for success and **false** for failure.

❌ Not recommended: Decorative emphasis
The function**returns** true **means** success, **returns** false **means** failure.

HTML Output

Markdown emphasis syntax is converted to HTML:

markdown
*italic*     → <em>italic</em>
**bold**   → <strong>bold</strong>
***bold italic*** → <strong><em>bold italic</em></strong>

Extended Syntax

Some Markdown processors support additional emphasis methods:

Strikethrough

markdown
~~strikethrough text~~

Rendered Output:strikethrough text

Underline

markdown
<u>underlined text</u>

Rendered Output:underlined text

Highlight

markdown
==highlighted text==  (supported by some processors)
<mark>highlighted text</mark>  (HTML tag)

Practical Examples

Technical Documentation

markdown
**API Endpoint**: `/api/users`

**Method**: *GET*

**Parameters**:
- *id* (***required***): User ID
- *format* (optional): Return format

**Return**: User info or **error message**

User Guide

markdown
## Installation Steps

**Step One**: Download the installer

Go to the official website download page and choose the version for your operating system. *Make sure to download the latest version*.

**Step Two**: Run the installer

Double-click the downloaded file and follow the wizard to complete the installation. ***Important***: Please disable antivirus software during installation.

**Step Three**: Verify installation

Open the command line and enter `app --version` to check if the installation was successful.

Practice

Try creating a document with the following:

  1. A product introduction highlighting key features in bold
  2. A technical explanation marking terms in italics
  3. A warning message using bold italic for importance
  4. Compound sentences mixing various emphasis styles

Built by www.markdownlang.com