0%

Markdown快速入门

Markdown快速入门

字体

  • 要创建粗体或斜体,请用星号*或下划线_括起来。
  • 单星号或下划线斜体,双星号或下划线粗体,可叠加粗斜体。
  • 若要避免创建粗体或斜体,请在前面或前面放置反斜杠。
  • 星号或下划线跟文本间不能留空白。

代码:

1
2
3
*Italics*
**Bold**
***Bold&Italics***

效果:
Italics
Bold
Bold&Italics

段落

  • 段落是连续的文本行,它们之间有一行或多行空白。
  • 对于换行符,请在行尾添加反斜杠或两个空格。

代码:

1
2
3
4
5
6
7
This is the first paragraph.

This is the second<!--注意行尾有两个空格-->
paragraph.

This is a\
line break.

效果:
This is the first paragraph.

This is the second
paragraph.

This is a
line break.

标题

  • 以一串#号加空格开头的行成为标题
    #号越多,标题越小(一到六级标题)

代码:

1
2
3
4
例如:
# Heading 1
## Heading 2
### Heading 3

效果:

Heading 1

Heading 2

Heading 3

  • 对于一级标题和二级标题也可使用=和-下划线格式(两个及两个以上)

代码:

1
2
3
4
Heading 1
==
Heading 2
-------

效果:
Heading 1
==
Heading 2


  • 可以在标题末尾通过空格加多个#号表示结束,个数无需匹配

代码:

1
2
3
例如:
### Heading 3 ##
#### Heading 4 #

效果:

Heading 3

Heading 4

块引用

  • 要创建块引用,请以大于>号的行开头,后跟可选空格。
  • 块引号可以嵌套,也可以包含其他格式。

代码:

1
2
3
4
5
6
> First line
> Another line
>
> > Nested line<!--可嵌套-->
>
>Last line<!--大于号和引用文本之间的空格是可选的-->

效果:

First line
Another line

Nested line

Last line

列表

  • 无序列表可以使用星号*、加号+或连字符-作为列表标记。
  • 有序列表使用数字后跟句点。或右括号),不一定从1开始。
  • 每个列表字符后面都需要一个空格。

代码:

1
2
3
4
5
6
7
* Apples
* Oranges
* Pears

1. First
2. Second
3. Third

效果:

  • Apples
  • Oranges
  • Pears
  1. First
  2. Second
  3. Third

    链接

  • URL文本需要用<>包起来,才会成为一个链接。
  • 链接可以与文本内联,也可以作为引用放置在文本的底部。
  • 链接文本由方括号[]括起来,对于内联链接,链接URL由()括起来
  • 也可以使用相对URL,例如 /example.html
  • 不要在任何括号之间加空格。[]()或[][]
  • 链接定义可以放置在空行之后的任何位置,但通常位于底部附近。
  • 定义标识符可以由字母、数字、空格和标点符号组成。它们不区分大小写。

代码:

1
2
3
4
5
6
7
<https://xlin007.github.io>

[text](http://a.com)

[text][id0]

[id0]: http://b.org/ "title"

效果:
https://xlin007.github.io

text

text

图片

  • 图片几乎与链接相同,但图片以感叹号开头!

代码:

1
2
3
4
5
6
![alt](Markdown快速入门/cat.png)

![alt][id1]


[id1]: Markdown快速入门/dog.jpg "title"

效果:
alt

alt

代码

  • 若要创建内联代码,请使用反单引号`进行包装。
  • 若要创建代码块,请将每行缩进4个空格,或在代码块上下的一行上放置3个反单引号```。
  • 代码块中的一级缩进等于4个空格或一个制表符。

代码:

Inline `code`

indent 4 spaces

1
2
3
4
5
6
7
	Or use 3 backticks
```

*效果:*
Inline `code`

indent 4 spaces

Or use 3 backticks

1
2
3
4
## 嵌套列表
- 若要将一个列表嵌套在另一个列表中,请将子列表中的每个项缩进四个空格。您还可以嵌套其他元素,如段落、引号或代码块。

*代码:*
  • Item
    1. First Subitem
    2. Second Subitem
  • Item
    • Subitem
    • Subitem
  • Item
    ```
  • 效果:*
  • Item
    1. First Subitem
    2. Second Subitem
  • Item
    • Subitem
    • Subitem
  • Item