Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents.

Markdown Basic Syntax

Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents.
几乎所有 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.

Rick Zheng

Rick Zheng

Scientist working on creating NekoMusume
Shanghai