Markdown语法学习

Markdown学习

Markdown标题

可以使用两种标记底线(=/-)和#（#(1-6） +空格键 +标题内容)
底线是=表示一级标题,底线是-表示二级标题且底线符合的数量至少2个

我展示的是一级标题
==

我展示的是二级标题
--

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

Markdown 标题编号

Markdown处理器支持标题的自定义ID 添加自定义ID允许您直接链接到标题并使用CSS对其进行修改。
要添加自定义标题ID，在与标题相同的行上用大括号括起该自定义ID。

1 2	`例如: ### My Great Heading {#custom-id}`

链接到标题ID (#headid)

通过创建带有数字符号（#）和自定义标题ID的标准链接，可以链接到文件中具有自定义ID的标题。
其他网站可以通过将自定义标题ID添加到网页的完整URL（例如[Heading IDs](https://markdown.com.cn/extended-syntax/heading-ids.html#headid)）来链接到标题。
1
[Heading IDs](https://markdown.com.cn/extended-syntax/heading-ids.html#headid)

Markdown段落

由一行或多行文本组成,不同段落之间使用空行标记.
行与行之间没有空行,则会被认为同一段落.
空行指的是行内什么都没有,或者只有空格和制表符
段落的换行是在上一行的结尾插入两个以上空格加上回车。当然也可以在段落后面使用一个空行来表示重新开始一个段落。

Markdown字体

粗体：在内容两边加入**两个(或下划线_*_)

hello word hello world

斜体：在内容两边加入**一个(或下划线_* )

hello word hello world

斜体加粗：在内容两边加入**三个(或下划线_* )

hello word

标记文本: 在内容两边加上==

==hello word==

上标:在内容两边加上^

x^2^

下标: 在内容两边加入~

删除线：在内容两边加上两个波浪线~ 号

~~hello~~
下划线 : 通过HTML的标签来实现

带下划线文本

Markdown 分隔线

至少三个-号或 * 号或_来标记

Markdown脚注

语法格式为 : [^要注明的文本内容]

例：

创建脚注^脚注名称

Markdown列表

Markdown支持有序列表和无序列表

无序列表使用星号(* )、加号(+)、或者减号(-)作为列表标记，这些标记后面要添加一个空格

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项

显示的效果：

第一项
第二项
第三项

第一项
第二项
第三项

第一项
第二项
第三项

有序列表使用数字序号+英文句号+空格+列表内容来表示

1
2
3

1. 第一项
2. 第二项
3. 第三项

显示的效果：

1. 第一项

2. 第二项

3. 第三项

任务列表

语法:为 :
- +空格+英文[ ]+内容未勾选

- +空格+英文[x]+内容已勾选
Write the press release
您可以通过单击项目前面的复选框来更改完成/未完成状态。

列表嵌套

列表的嵌套只需在子列表前加上一个Tab键 (减号- 和空格)

第一项:
- 第一项嵌套的一个元素
- 第一项嵌套的二个元素
第二项:
- 第二项嵌套的一个元素
- 第二项嵌套的二个元素

Markdown 引用

Markdown区块引用是在段落开头使用**>**符号，然后紧跟一个空格：

洋洋要开森

另外区块是可以嵌套的一个>是最外面，两个>符号是第一层的嵌套：

最外层

第一层嵌套

第二次嵌套

区块中使用列表:

区块中使用列表:

第一项

第二项

第一项

第二项

列表中使用区块：

第一项

洋洋要开森
插入标记符号不想被符号渲染,可以使用\进行转义语法如下:
- \ 特殊符号
  1
  2
  3
  4
  5
  例如: \ \ \ * \[]

Markdown代码

行内代码:

如果是段落上的一个函数或者片段的代码可以用反引号给他包起来(`),例如:
```
`println` 函数
```

代码区块

代码区块使用Tab键（在编辑模式下）或者4个空格开头以及使用三个`或者三个~包裹一段代码

以Tab键开头:

def test_print():
    pass

1	`public static void main(String[]args){println"Hello,world"}`

Markdown链接

链接使用方法如下：

[ 链接名称](链接地址 "超链接title")
或者
<链接地址>

<www.baidu.com>

1	`这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。`

这是一个链接 Markdown语法。

引用链接

在正文中引用链接标记
[链接文字][链接标记]

在底部中定义链接标记
[链接标记]: 链接地址

语法说明如下:

链接标记可以有字母|数|空格|标点符号.
链接标记不分大小写
链接地址为网络地址时要以http或https 开头

这个链接用 runoob 作为网址变量 Runoob

Markdown图片

Markdown图片语法格式如下:

1
2
3

![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "图片title")

图片可以是本地图片的路径或者网络图片的地址
本地图片支持绝对路径和相对路径

1
2
3

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

图片链接

给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中。

1 2	`[![沙漠中的岩石图片](/assets/img/shiprock.jpg "Shiprock")](https://markdown .com.cn)`

当然，你也可以像网址那样对图片网址使用变量:

这个链接用 1 作为网址变量 [RUNOOB][1].
然后在文档的结尾为变量赋值（网址）

[1]: http://static.runoob.com/images/runoob-logo.png

这个链接用 1 作为网址变量 RUNOOB.
然后在文档的结尾为变量赋值（网址）

Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用普通的标签。

1	`<img decoding="async" src="http://static.runoob.com/images/runoob-logo.png" width="50%">`

显示结果如下：

Markdown 表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

语法格式如下：

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

表头	表头
单元格	单元格
单元格	单元格

语法说明:

单元格之间使用| 来分隔
单元格和|之间的空格会被移除
表头与其他行使用- 来分隔
对齐方式

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

实例如下：

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

以上代码显示结果如下：

Markdown 高级技巧

支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> 等，如：

1	`使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑`

输出结果为：

转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：

1 2	`文本加粗 \\ 正常显示星号 \\`

输出结果为：

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

公式

Markdown Preview Enhanced 使用 KaTeX 或者 MathJax 来渲染数学表达式。

KaTeX 拥有比 MathJax 更快的性能，但是它却少了很多 MathJax 拥有的特性。你可以查看 KaTeX supported functions/symbols 来了解 KaTeX 支持那些符号和函数。

默认下的分隔符：

$...$ 或者 $...$ 中的数学表达式将会在行内显示。
$$...$$ 或者 \[...\] 或者 ````math` 中的数学表达式将会在块内显示。

$$
\begin{Bmatrix}
   a & b \\
   c & d
\end{Bmatrix}
$$
$$
\begin{CD}
   A @>a>> B \\
@VbVV @AAcA \\
   C @= D
\end{CD}
$$

输出结果为：

Markdown 使用 Emoji 表情

有两种方法可以将表情符号添加到Markdown文件中：将表情符号复制并粘贴到Markdown格式的文本中，或者键入emoji shortcodes

复制和粘贴表情符号

在大多数情况下，您可以简单地从Emojipedia 等来源复制表情符号并将其粘贴到文档中。许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。

Tip: 如果您使用的是静态网站生成器，请确保将HTML页面编码为UTF-8。.

使用表情符号简码

一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾，并包含表情符号的名称。

去露营了！ :tent: 很快回来。

真好笑！ :joy:
:smile:
:laughing:
:+1:
:-1:
:clap:

呈现的输出如下所示：

去露营了！⛺很快回来。

真好笑！😂

:smile:
:laughing:

:+1:
:-1:
:clap:

功能快捷键

快速转换源代码模式:ctrl + /
撤销：Ctrl/Command + Z
粗体：Ctrl/Command + B
斜体：Ctrl/Command + I
插入图片：Ctrl/Command + Shift + I
插入链接:Ctrl/Command + Shift + K
删除线:Alt + Shift + 5
设置几级标题：Ctrl + 数字(1-5)
提升/降低标题等级:Ctrl + =(-)
设置为普通文本:Ctrl + 0(数字零)
添加有序列表:Ctrl + Shift +[
添加无序列表:Ctrl + Shift +]
增加缩进:Ctrl +]
减少缩进:Ctrl + [
添加引用:Ctrl +Shift +Q
添加表格:Ctrl +T
添加代码块:Ctrl +Shift +K
添加下划线:Ctrl+ U
添加注释:
重做：Ctrl/Command + Y
选择当前词:Ctrl +D
选择当前行:Ctrl +L
选择当前格式文本:Ctrl +E
查找：Ctrl/Command + F

[^要注明的文本内容]:

Markdown 排版小技巧

建议中文和英文之间加空格,中文/英文与数据之间也加空格.

一些需要加空格的情况

英文标点符号(,:;?)与后面的字符之间加空格

当中文或英文使用>(半角)表示路径时,两边加上空格
不需要加空格的情况

中文标点符号和数字、中文、英文之间不需要添加空格

数字和百分号之间不需要添加空格

数字和单位符号之间不需要添加空格

英文和数字组成合成的名字不需要添加空格

当/(半角)表示”或”、”路径”时,与前后的字符之间均不加空格

货币符号后不加空格

负号后不加空格

全角与半角:

全角:中文标点符号是全角,占两个字节

半角:英文标点符号是半角,占一个字节

全角: ，。；：！#

半角:,.;:!#

在中文排版中,使用全角标点符号。

英文排版中,使用半角标点符号。

专有名词使用正确大小写。

blog

#Markdown

Markdown语法学习

http://yyyks5836.github.io/2023/12/20/Markdown语法学习/

作者

洋洋要开森

发布于

2023年12月20日

更新于

2023年12月27日

许可协议

一小时Git教程上一篇

Hello World 下一篇