标题
要创建标题,请#
在单词或短语前面添加数字符号 ( )。您使用的数字符号数量应与标题级别相对应。例如,要创建三级标题 ( <h3>
),请使用三个数字符号(例如### My Header
)。
Markdown | HTML | |
---|---|---|
# Heading level 1 | <h1>Heading level 1</h1> | |
## Heading level 2 | <h2>Heading level 2</h2> | |
### Heading level 3 | <h3>Heading level 3</h3> | |
#### Heading level 4 | <h4>Heading level 4</h4> | |
##### Heading level 5 | <h5>Heading level 5</h5> | |
###### Heading level 6 | <h6>Heading level 6</h6> |
替代语法
或者,在文本下方的行中,添加任意数量的==
1 级标题字符或--
2 级标题字符。
Markdown | HTML | |
---|---|---|
Heading level 1 | <h1>Heading level 1</h1> | |
Heading level 2 | <h2>Heading level 2</h2> |
标题最佳实践
Markdown 应用程序对于如何处理数字符号 ( #
) 和标题名称之间缺少的空格意见不一。出于兼容性考虑,请始终在数字符号和标题名称之间留一个空格。
✅ 这样做 | ❌ 不要这样做 |
---|---|
# Here's a Heading | #Here's a Heading |
为了兼容性,您还应该在标题前后放置空行。
✅ 这样做 | ❌ 不要这样做 |
---|---|
Try to put a blank line before... | Without blank lines, this might not look right. |
段落
要创建段落,请使用空行分隔一行或多行文本。
Markdown | HTML | |
---|---|---|
I really like using Markdown. | <p>I really like using Markdown.</p> |
段落最佳实践
除非段落在列表中,否则不要使用空格或制表符缩进段落。
✅ 这样做 | ❌ 不要这样做 |
---|---|
Don't put tabs or spaces in front of your paragraphs. |
|
换行符
要创建换行符或新行 ( <br>
),请用两个或更多空格结束一行,然后键入回车键。
Markdown | HTML | 渲染输出 |
---|---|---|
This is the first line. | <p>This is the first line.<br> | 这是第一行。 |
换行最佳实践
几乎每个 Markdown 应用程序中都可以使用两个或更多空格(通常称为“尾随空格”)作为换行符,但这是存在争议的。在编辑器中很难看到尾随空格,许多人会无意或故意在每个句子后放两个空格。因此,您可能希望使用除尾随空格以外的其他符号作为换行符。如果您的 Markdown 应用程序支持 HTML,则可以使用<br>
HTML 标签。
<br>
为了兼容性,请在行尾使用尾随空格或HTML 标签。
还有两个我不推荐使用的选项。CommonMark 和其他一些轻量级标记语言允许您\
在行尾输入反斜杠 ( ),但并非所有 Markdown 应用程序都支持此功能,因此从兼容性角度来看,这不是一个好选择。至少有几种轻量级标记语言不需要在行尾输入任何内容 - 只需输入回车键即可创建换行符。
✅ 这样做 | ❌ 不要这样做 |
---|---|
First line with two spaces after. | First line with a backslash after.\ |
强调
粗体
要加粗单词中间部分以示强调,请在字母周围添加两个星号(不带空格)。
Markdown | HTML | Rendered Output |
---|---|---|
I just love **bold text**. | I just love <strong>bold text</strong>. | I just love bold text. |
I just love __bold text__. | I just love <strong>bold text</strong>. | I just love bold text. |
Love**is**bold | Love<strong>is</strong>bold | Loveisbold |
粗体的最佳实践
✅ 这样做 | ❌ 不要这样做 |
---|---|
Love**is**bold | Love__is__bold |
斜体
要使单词中间部分变成斜体以示强调,请在字母周围添加一个星号(不带空格)。
Markdown | HTML | 渲染输出 |
---|---|---|
Italicized text is the *cat's meow*. | Italicized text is the <em>cat's meow</em>. | 斜体文字是猫叫声。 |
Italicized text is the _cat's meow_. | Italicized text is the <em>cat's meow</em>. | 斜体文字是猫叫声。 |
A*cat*meow | A<em>cat</em>meow | 一只猫喵喵叫 |
斜体的最佳实践
✅ 这样做 | ❌ 不要这样做 |
---|---|
A*cat*meow | A_cat_meow |
粗体和斜体
要将单词中间部分加粗并设为斜体以强调,请在字母周围添加三个星号(不带空格)。
Markdown | HTML | 渲染输出 |
---|---|---|
This text is ***really important***. | This text is <em><strong>really important</strong></em>. | 这篇文章确实很重要。 |
This text is ___really important___. | This text is <em><strong>really important</strong></em>. | 这篇文章确实很重要。 |
This text is __*really important*__. | This text is <em><strong>really important</strong></em>. | 这篇文章确实很重要。 |
This text is **_really important_**. | This text is <em><strong>really important</strong></em>. | 这篇文章确实很重要。 |
This is really***very***important text. | This is really<em><strong>very</strong></em>important text. | 这确实是非常重要的文本。 |
粗体和斜体的最佳实践
✅ 这样做 | ❌ 不要这样做 |
---|---|
This is really***very***important text. | This is really___very___important text. |