Markdown 基本语法
标题语法
标题语法为了直观呈现文章的内容主旨和结构层次
要创建标题,请在单词或短语前面添加
#
号 。#
号的数量代表了标题的级别。
№ | Markdown语法 | HTML | 预览效果 |
---|---|---|---|
0 | # 一级标题 | <h1>一级标题</h1> |
一级标题 |
1 | ## 二级标题 | <h2>二级标题</h2> |
二级标题 |
2 | ### 三级标题 | <h3>三级标题</h3> |
三级标题 |
3 | #### 四级标题 | <h4>四级标题</h4> |
四级标题 |
4 | ##### 五级标题 | <h5>五级标题</h5> |
五级标题 |
5 | ###### 六级标题 | <h6>六级标题</h6> |
六级标题 |
6 | 可选语法 |
||
7 | 一级标题 ======= |
<h1>一级标题</h1> |
一级标题 |
8 | 二级标题 ——- |
<h2>二级标题</h2> |
二级标题 |
换行语法
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行
<br>
№ | Markdown语法 | HTML | 预览效果 |
---|---|---|---|
0 | 这是第一行. |
<p>这是第一行.<br>这是第二行.</p> |
这是第一行. |
段落语法
使用空白行 将一行或多行文本进行分隔
不要用空格(spaces)或制表符(tabs)缩进段落。
№ | Markdown语法 | HTML | 预览效果 |
---|---|---|---|
0 | 这是第一段第一行 这是第二段第一行 |
<p>这是第一段第一行</p> <p>这是第二段第一行</p> |
这是第一段第一行 这是第二段第一行 |
引用语法
>
引用语法注意空格
多段落引用 为段落之间的空白行添加一个>
>>
多级引用
>>>
多级引用
强调语法
强调语法主要应用于文章内容的关键信息,以醒目突出展示
- 粗体
单词或短语的前后各添加
**
或__
加粗1 加粗2
在单词或短语中间部分加粗的话,请使用**
- 斜体
在单词或短语前后添加
*
或_
斜体1 斜体2
在单词或短语中间部分加粗的话,请使用*
我的小斜体呀
- 粗体+斜体
在单词或短语的前后各添加
***
或___
粗斜体1 粗斜体2
在单词或短语中间部分加粗斜体的话,请使用***
我加了一个粗斜体
删除
单词或短语的前后各添加
~~
删除
列表
有序列表
在每个列表项前添加1.
。数字不必按数学顺序排列,但是列表应当以数字 1 起始,注意空格
- 第一项
- 第一小项
- 继续往下延伸
- 还能继续吗
- 继续往下延伸
- 第一小项
- 第二项
无序列表
在每个列表项前面添加-
、*
或+
。缩进一个或多个列表项可创建嵌套列表,注意空格
处理同一列表中的不同分隔符。为了兼容性,不要在同一级列表中混合和匹配分隔
- 我是一张弓
- 开弓没有回头箭
- 让箭飞一会
- 开弓没有回头箭
- 站似一棵树
定义列表
定义列表:在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义
- First Term
- This is the definition of the first term.
- Second Term
- This is one definition of the second term.
- This is another definition of the second term.
任务列表
任务列表使您可以创建带有复选框的项目列表
创建任务列表:在任务列表项之前添加减号和方括号- [ ]
,。要选择一个复选框,请在方括号[x]之间添加 x
- Write the press release
- Update the website
- Contact the media
代码
代码块
要将单词或短语表示为代码,请将其包裹在反引号
`code`
转义反引号
要表示代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号
Use Your `Code` in Markdown File
多行代码
将代码块的每一行缩进至少四个空格或一个制表符 或用前后三个反引号
许多Markdown处理器都支持受围栏代码块的语法高亮显示。
在受防护的代码块之前的反引号旁边指定一种语言。
public func setup(data:Any){
}
1``` swift
2public func setup(data:Any){
3
4}
5\```
分割语法
分割语法用于要结束当前内容,分割两块不同的内容
在单独一行上使用三个或多个星号
***
、连字符---
或下划线___
,并且不能包含其他内容
链接语法
链接文本放在中括号内,链接地址放在后面的括号中,
[超链接显示名称](超链接地址 "链接title是当鼠标悬停在链接上时会出现的文字")
title是可选的
Markdown语法
使用尖括号可以很方便地把URL或者email地址变成可点击的链接
https://markdown.com.cn , markdown@example.com
强调链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号
I love supporting the EFF.
This is the Markdown Guide.
See the section oncode
.
引用链接
[markdown] 1
1[markdown] [1]
2
3[1]: https://www.markdownguide.org
图片语法
普通图片
![替代文本](图片地址 "图片标题")
转译字符语法
普通字符转译
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符
\\
,\*
,\_
,\{}
,\[]
,\()
,\#
,\+
,\-
,\.
,\!
,\|
特殊字符转译
在 HTML 文件中,有两个字符需要特殊处理: < 和 &
< 符号用于起始标签,& 符号则用于标记 HTML 实体
你必须要使用实体的形式,是<
和&
表格
要添加表格,请使用三个或多个连字符
---
创建每列的标题,并使用|
分隔每列。
可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号:
,将列中的文本对齐到左侧,右侧或中心。
可以在表格中添加链接,代码
,和强调语法
1| Syntax | Description | Test Text |
2| :--- | :----: | ---: |
3| Header | Title | Here's this |
4| Paragraph | Text | And more |
№ | Syntax | Description | Test Text |
---|---|---|---|
0 | Header | Title | Here’s this |
1 | Paragraph | Text | And more |
脚注语法
说明
脚注使您可以添加注释和参考,而不会使文档正文混乱
带有脚注的上标数字会出现在添加脚注参考的位置,可以单击链接以跳至页面底部的脚注内容
方括号[^1]
内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符
标识符仅将脚注参考与脚注本身相关联-在输出中,脚注按顺序编号
示例
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: bignote
Emoji 表情
目录语法
[TOC]
标签语法
内嵌 HTML 语法
行级标签
HTML 的行级內联标签如
<span>
、<cite>
、<del>
不受限制,可以在 Markdown 的段落、列表或是标题里任意使用
This word is bold. This word is italic.
块级标签
区块元素──比如
<div>
、<table>
、<pre>
、<p>
等标签,必须在前后加上空行,以便于内容区分
<table>
<tr>
<td>Foo</td>
</tr>
</table>
Foo |