Markdown 示例 - 如何快速入门 Markdown

这是一篇示例文章,测试 Markdown 展示效果。


一、.Markdown 标题

Markdown 支持两种标题的语法:Setext 形式和 Atx 形式

1. Setext 形式

Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)

例如:

图片.png

2. Atx 形式

Atx 形式在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

图片.png

标题的使用在 Markdown 使用中非常频繁,一般以自己使用习惯来就行,不过大部分软件都支持第二种 # 类型的标题样式,第一种平常用的偏少。

二、区块引用

区块引用则使用 email 形式的 ‘>’ 角括号。

例如:
> 引用
> 
> > 引用中的引用
>
> ## 引用中的标题

引用

引用中的引用

引用中的标题

Markdown 使用星号和底线来标记需要强调的区段。单标记表示斜体,双标记表示粗体

例如:
使用单星号: *星号斜体*
使用单下划线: _下划线斜体_
使用双星号: **星号粗体**
使用双下划线: __下划线粗体__
删除线:~~删除线~~
  • 使用单星号: 星号斜体
  • 使用单下划线: 下划线斜体
  • 使用双星号: 星号粗体
  • 使用双下划线: 下划线粗体
  • 删除线:删除线

三、无序列表

无序列表:使用星号(*)、加号(+)和减号(-)来做为列表的项目标记

星号、加号、减号:
* Candy.
+ Gum.
- Booze.
  • Candy.
  • Gum.
  • Booze.

四、有序列表

有序列表:使用一般的数字接着一个英文句点作为项目标记,数字不能省略但可无序,点号之后的空格不能少

1. Red
2. Green
3. Blue
  1. Red
  2. Green
  3. Blue

五、嵌套列表:

-+* 可循环使用,但符号之后的空格不能少,符号之前的空格也不能少

- 嵌套列表1
+ 嵌套列表1a
+ 嵌套列表1b
- 嵌套列表1ai
	* 嵌套列表1aix
	- 嵌套列表2
  • 嵌套列表 1
    • 嵌套列表 1a
      • 嵌套列表 1ai
        • 嵌套列表 1aix
    • 嵌套列表 1b
  • 嵌套列表 2

三个或更多 -_*,必须单独一行,可含空格(注意如果在文字后使用 —,则为副标题)

此外有序列表和无序列表有多级的话也可以通过 TabShift + Tab 缩进实现。

六、插入链接

在 Markdown 中,插入链接不需要其他按钮,你只需要使用[显示文本](链接地址) 这样的语法即可,例如:

文字超链:[GitHub](http://www.github.com)
索引超链:
[Google][1] [1]:http://www.google.com
自动链接:http://www.google.com 
邮箱链接:<myemail@email.com>

文字超链: GitHub

索引超链: Google

自动链接:http://www.google.com

邮箱链接:myemail@email.com

七、图片超链

在 Markdown 中,插入图片不需要其他按钮,你只需要使用 ![image](https://xxx.jpg] 这样的语法即可,例如:

![congjinyebaiya](https://cdn.hashnode.com/res/hashnode/image/upload/v1650872248441/srP9RSsrv.png)

Markdown 示例

注:插入图片的语法和链接的语法很像,只是前面多了一个 !。*

八、代码块

`字符`(简短文字添加代码框)
`Tab`或四个空格(大段文字添加代码框,每行前添加)

字符
Tab或四个空格

九、大段代码块

在你的代码块的前面和后面都加上三个反引号 ` 即可,在第一行后指定编程语言,也可以不指定

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

十、特殊符号

特殊符号前可以加反斜线表示转义

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
  • \ 反斜杠
  • ` 反引号
  • * 星号
  • _ 下划线
  • {} 大括号
  • [] 中括号
  • () 小括号
  • + 加号
  • - 减号
  • . 英文句号
  • ! 感叹号

十一、表格

  • 使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行:
name | age   区分单元格
---- | ---         分隔表头和其他行
LearnShare | 12
Mike | 32
nameage
LearnShare12
Mike32
  • 为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用来标记单元格边界:
| name       | age |
| ---------- | --- |
| LearnShare | 12  |
| Mike       | 32  |
nameage
LearnShare12
Mike32
  • 在表头下方的分隔线标记中加入 :,即可标记下方单元格内容的对齐方式:
| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
leftcenterright
aaaabbbbbbccccc
abc

十二、分隔线

---