几乎所有 Markdown 应用程序都支持原始 Markdown 设计文档中概述的基本语法。Markdown 处理器之间存在细微差异和矛盾 — 我们会尽可能地在行内注明。
标题
要创建标题,请在单词或短语前面添加数字符号#
。您使用的数字符号数量应与标题级别相对应。
# Heading level 1
## Heading level 2
### Heading level 3
标题-替代语法
或者,在文本下方的行中,添加任意数量的==
或--
。
Heading level 1
===============
Heading level 2
---------------
段落
要创建段落,请使用空行分隔一行或多行文本。
I really like using Markdown.
I think I'll use it to format all of my documents from now on.
换行符
要创建换行符或新行 (<br>
),请用两个或更多空格结束一行,然后键入回车键。
This is the first line.
And this is the second line.
强调-加粗
要加粗文本,请在单词或短语前后添加两个星号或下划线。要加粗单词中间部分以示强调,请在字母周围添加两个星号(不带空格)。
I just love **bold text**.
I just love __bold text__.
Love**is**bold
强调-斜体
要使文本变成斜体,请在单词或短语前后添加一个星号或下划线。要使单词中间部分变成斜体以示强调,请在字母周围添加一个星号(不带空格)。
Italicized text is the *cat's meow*.
Italicized text is the _cat's meow_.
A*cat*meow
强调-粗体和斜体
要同时使用粗体和斜体强调文本,请在单词或短语前后添加三个星号或下划线。要将单词中间部分加粗并设为斜体以强调,请在字母周围添加三个星号(不带空格)。
This text is ***really important***.
This text is ___really important___.
This text is __*really important*__.
引用
要创建块引用,请在段落前面添加>
。
> Dorothy followed her through many of the beautiful rooms in her castle.
列表-有序列表
要创建有序列表,请添加带有数字和句点的行项目。数字不必按数字顺序排列,但列表应从数字 1 开始。
1. First item
2. Second item
3. Third item
4. Fourth item
列表-无序列表
要创建无序列表,请在行项目前添加破折号 (-
)、星号 (*
) 或加号 (+
)。缩进一个或多个项目以创建嵌套列表。
- First item
- Second item
- Third item
- Fourth item
代码
要将单词或短语表示为代码,请将其括在反引号 (`
) 中。
At the command prompt, type `nano`.
代码-转义反引号
如果要用代码表示的单词或短语包含一个或多个反引号,则可以通过将单词或短语括在双反引号 (``
) 中来将其转义。
``Use `code` in your Markdown file.``
代码块
要创建代码块,请将块的每一行缩进至少四个空格或一个制表符。
<html>
<head>
</head>
</html>
水平线
要创建水平线,请在一行上使用三个或更多星号 (***
)、破折号 (---
) 或下划线 (___
)。
***
---
_________________
链接
要创建链接,请将链接文本括在括号中(例如[HeiBuNeko's Blog]
),然后在其后紧接着括号中的 URL(例如(https://heibuneko.site)
)。
[HeiBuNeko's Blog](https://heibuneko.site)
链接-添加标题
您可以选择为链接添加标题。当用户将鼠标悬停在链接上时,标题将显示为工具提示。要添加标题,请在 URL 后用引号将其括起来。
[HeiBuNeko's Blog](https://heibuneko.site "ミヤネコサイト")
链接-URL 和电子邮件地址
要快速将 URL 或电子邮件地址转换为链接,请将其括在尖括号中。
<https://heibuneko.site>
<heibusan@gmail.com>
链接-格式化链接
要强调链接,请在括号和圆括号前后添加星号。要将链接表示为代码,请在括号中添加反引号。
I love supporting the **[HeiBuNeko's Blog](https://heibuneko.site)**.
This is the *[HeiBuNeko's Blog](https://heibuneko.site)*.
See the section on [`code`](#code).
链接-将各部分组合在一起的示例
it was a [hobbit-hole][1], and that means comfort.
[1]: <https://heibuneko.site> "ミヤネコサイト"
图片
要添加图片,请添加感叹号 (!
),后跟括号中的替代文本,以及括号中图片资源的路径或 URL。您可以选择在路径或 URL 后添加引号中的标题。
![HeiBuNeko's Blog](https://heibuneko.site/content/images/2024/08/Profile-Cover.jpg "ミヤネコサイト")
图片-链接图片
要添加图像的链接,请将图像的 Markdown 括在括号中,然后在括号中添加链接。
[![HeiBuNeko's Blog](https://heibuneko.site/content/images/2024/08/Profile-Cover.jpg "ミヤネコサイト")](https://heibuneko.site)
转义字符
要显示用于格式化 Markdown 文档中的文本的文字字符,请在字符前添加反斜杠 (\
)。
\* HeiBuNeko's Blog
HTML
要使用 HTML,请将标签放在 Markdown 格式文件的文本中。
This **word** is bold. This <em>word</em> is italic.