Home Markdown简述(学习笔记)
Post
Cancel

Markdown简述(学习笔记)

引言

最近因建网盘网站了解了一下 Markdown,发现这玩意非常好用,于是写一份学习笔记

可以通过在线编辑器边看边学,也可下载一些编辑器

个人编写Markdown的工具为 Typora

复习可以去看官方的速查表 Markdown 语法速查表

标题

创建一个标题,仅需#+空格+标题文字,一共有六级,对应 HTML 的 h1~h6

例如以下代码

1
2
3
4
5
# 这是一级标题
## 这是二级标题
### 这是三级标题
······
###### 这是六级标题

效果如下

这是一级标题

这是二级标题

这是三级标题

······

这是六级标题

换行

仅需在上一行末尾加上俩个以上空格后回车即可,有些编辑器可直接换行

例如以下代码

1
2
这是第一行  //这里有俩空格  
这是第二行

效果如下

这是第一行 //这里有俩空格

这是第二行

斜体 & 粗体

斜体为文本前后加一个*,粗体为文本前后加俩**

例如以下代码

1
2
3
*这是斜体*  
**这是粗体**  
***这是斜体加粗体***

效果如下

这是斜体

这是粗体

这是斜体加粗体

引用

创建引用区块仅需在段首添加>+空格+内容

例如以下代码

1
2
3
> 这是一级引用
>> 这是二级引用
>>> 这是三级引用 

效果如下

这是一级引用

这是二级引用

这是三级引用

列表

可以创建有序列表和无序列表

有序列表

在列表项前添加数字+.+空格+内容即可

例如以下代码

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

效果如下

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

无序列表

使用+-*+空格+ 内容即可,但请不要混用 (为了兼容性)

子项可以使用四个空格或一个TAB然后用父项格式即可

例如以下代码

1
2
3
4
5
6
* 第一项
    * 第一项子一项
    * 第一项子二项
        * 第一项子二项子一项
* 第二项
* 第三项

效果如下

  • 第一项
    • 第一项子一项
    • 第一项子二项
      • 第一项子二项子一项
  • 第二项
  • 第三项

代码

单行

将要变为代码的内容放在”`“中即可,如果代码中有”`“,请使用”``”

例如以下代码

1
2
`将此内容变为代码块`
``此内容中含有'`'哦~``

效果如下

将此内容变为代码块

此内容中含有'`'哦~

代码块

可以通过将每一行缩进四个空格或一个TAB

或者上下行”```“包围,要使用高亮,请在上方”```“后写上语言类型

例如以下代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 这是使用缩进的C代码
    include<stdio.h>
    int main(void)
    {
        printf("Hello World");
    }
// 这是使用```的C代码
``` C
include<stdio.h>
int main(void)
{
    printf("Hello World");
}
```

效果如下

// 这是使用缩进的 C 代码

1
2
3
4
5
include<stdio.h>
int main(void)
{
    printf("Hello World");
}

// 这是使用”```“的 C 代码

1
2
3
4
5
include<stdio.h>
int main(void)
{
    printf("Hello World");
}

注:第一种(缩进)部分Markdown编辑器不支持

分割线

在单独一行使用三个及以上的*-_即可

例如以下代码

1
2
3
***
--------
_____

效果如下




链接

简易链接

直接将链接或邮箱地址使用 <> 括起来即可

例如以下代码

1
2
<https://yexca.net>  
<[email protected]>

效果如下

https://yexca.net
[email protected]

自定义文字的链接

[超链接显示名](超链接地址 "超链接title"),其中 "超链接title" 可以不填

例如以下代码

1
2
[yexca的博客](https://blog.yexca.net)  
[yexca的博客](https://blog.yexca.net "其实是yexca和Hiyoung的博客")

效果如下

yexca的博客
yexca的博客

引用类型链接

例如以下代码

1
2
3
4
[blog]: https://blog.yexca.net
[contact]: <[email protected]>

这是我的[个人博客][blog],有问题可以[联系我][contact]

效果如下

这是我的个人博客,有问题可以联系我

图片

插入图片

![图片alt](图片链接 "图片title"),其中‘图片 alt’为当图片加载失败时显示的内容,‘图片 title’为鼠标放图片上显示的内容

注意:部分Markdwon编辑器不支持图片title

例如以下代码

1
![图片](https://cdn.statically.io/gh/yexca/picx-images-hosting@master/2023/04-网站背景/blog-background.2p10z489pjc0.webp "这是本站的背景")

效果如下

图片

图片包含链接

使用链接的语法,将图片放在‘[]’里即可

例如以下代码

1
[![图片](https://cdn.statically.io/gh/yexca/picx-images-hosting@master/2023/04-网站背景/blog-background.2p10z489pjc0.webp)](https://www.pixiv.net/artworks/82542737)

效果如下

图片

转义字符

如果有不想被 Markdown 格式化的字符,只需要在前方加上‘\’即可

例如以下代码

1
2
我想打出*但这会被斜体*  
加上转移符\*后面就不会斜体\*而且可以显示

效果如下

我想打出但这会被斜体

加上转移符 * 后面就不会斜体 * 而且可以显示

内嵌 HTML

直接使用即可,以缩略标签为例

例如以下代码

1
2
3
4
5
6
7
<details>
    <summary>
        点我试试
    </summary>
被发现啦
</details>
我可以用Markdown**变粗**,也可以同时用HTML<i>变斜</i>

效果如下

点我试试 被发现啦

我可以用Markdown变粗,也可以同时用HTML变斜

表格

使用三个或多个-创建每列标题,使用|分割每列,使用:以左,右或居中对齐 (非必须)

例如以下代码

1
2
3
|标题|内容|备注|
|:---|:---:|---:|
|左对齐|居中|右对齐|

效果如下

标题 内容 备注
左对齐 居中 右对齐

注意:不可以在表格中添加标题,引用,列表,图像或 HTML 标签等

删除线

在要删除的内容前后添加~~

例如以下代码

1
我永远喜欢~~战争文学博士~~Warma

效果如下

我永远喜欢战争文学博士 Warma

任务列表

使用-+空格+[ ][x]+空格+内容

例如以下代码

1
2
- [ ] 这个没完成呢
- [x] 这个完成啦 

效果如下

  • 这个没完成呢
  • 这个完成啦

使用 Emoji 表情

复制粘贴

多数情况可直接复制 Emojipedia 上的表情直接粘贴,请确保网页编码为’UTF-8‘

使用表情符号简码

这个需要 Markdown 应用程序支持,以冒号:开头和结尾

可以通过表情符号简码列表查询

例如以下代码

1
:blush:,:smiley:

效果如下

😊,😃

脚注

例如以下代码

1
2
3
4
5
6
这里引用了维基百科[^1],这里引用了Github[^2]。
也可以使用英文,但不能用空格或TAB[^yexca]

[^1]: 这里可以使用文字,然后会在上方相应位置出现
[^2]: 或者使用链接[Github](https://github.com)
[^yexca]: [个人主页](https://blog.yexca.net)

这里引用了维基百科1,这里引用了Github2。 也可以使用英文,但不能用空格或TAB3

注意:部分编辑器不支持

参考文章

Markdown 官方教程

Markdown 学习

  1. 这里可以使用文字,然后会在上方相应位置出现 

  2. 或者使用链接Github 

  3. 个人主页 

This post is licensed under CC BY 4.0 by the author.

プロセカ的IP规则

Github Pages建站及自定义域名