Markdown学习

简介

Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。

Markdown有什么好处,一个是可以语法非常简单,很好学,二是不用花很多时间在排版上,第三个生成文件非常小,可以多平台发布,比如hexo之类的博客文章就是通过Markdown来写的,WordPress虽然用的是古腾堡编辑器,但也是专门的Markdown插件,写好以后复制粘贴即可发布。

常用编辑器:VSCode编辑器,Typora

(注:VSCode肯定是免费的,Typora现在已经要花钱了,可以在网上下免费老版本用)

Markdown基本语法

标题

1、使用 = 和 - 标记一级和二级标题

输入标题文字,shift + enter 另起一行, 输入两个或两个以上 “ = / - ” 。

我展示的是一级标题
=================

我展示的是二级标题
-----------------

2、使用#号标记

使用 #号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推

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

段落和字体

Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车

字体

*辉辉是大帅哥*
_辉辉是大帅哥_
**辉辉是大帅哥**
__辉辉是大帅哥__
***辉辉是大帅哥***
___辉辉是大帅哥___

如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线即可

~~辉辉是大帅哥~~

下划线可以通过 HTML 的<u>标签来实现

辉辉是大帅哥

列表

Markdown 支持有序列表和无序列表。无序列表使用星号(***)、加号(+)或是减号(-**)作为列表标记,这些标记后面要添加一个空格。

* 辉辉是大帅哥
+ 辉辉是大帅哥
- 辉辉是大帅哥
  • 辉辉是大帅哥

  • 辉辉是大帅哥

  • 辉辉是大帅哥

有序列表使用数字并加上 . 号来表示

1. 辉辉真是帅
2. 辉辉是大帅哥
  1. 辉辉真是帅
  2. 辉辉是大帅哥

列表嵌套:只需在子列表中的选项前面添加四个空格即可。

1. 辉辉为什么是大帅哥
    - 因为辉辉五官端正
    - 因为辉辉身材好
  1. 辉辉为什么是大帅哥
    • 因为辉辉五官端正
    • 因为辉辉身材好

引用

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

> 区块引用

区块引用

区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套

> 最外层
> > 第一层嵌套
> > >第二层嵌套

最外层

第一层嵌套

第二层嵌套

区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项

区块中使用列表

  1. 第一项
  2. 第二项

列表中使用区块

如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进

* 第一项
    > 辉辉帅
    > 辉辉好帅
* 第二项
  • 第一项

    辉辉帅
    辉辉好帅

  • 第二项

代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来

`function()`函数

function()函数

可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定)

#include<stdio.h>
int main(void) {
    printf("Hello,World!");
}

链接

链接使用方法:

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

辉辉的魔法空间

https://huihuige.xyz

链接标记可以有字母、数字、空格和标点符号;链接标记不区分大小写;定义的链接内容可以放在当前文件的任意位置;当链接地址为网络地址时要以http/https开头,否则会被识别为本地地址。

图片

图片语法格式:

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

类似于HTML中图像标签,里面alt是图片不能显示时替代文本,也可以加上双引号包括文字得到鼠标悬停显示内容,类似图片标签title属性

[![新垣结衣](https://img.huihuige.xyz/images/2022/02/12/3f791fca358861674eaf3623aa0c56df.gif "新垣结衣")

新垣结衣

如果不能正常显示

新垣结衣

表格

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

语法格式:

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

对齐方式:

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

Markdown扩展语法

转义

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

**文本加粗** 
\*\* 正常显示星号 \*\*

文本加粗
** 正常显示星号 **

Markdown支持以下这些符号前面加上反斜杠来帮助插入普通的符号
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

表情符号

包裹表情代码:

:smile:
:+1:
:-1:

:smile: :+1: :-1:

任务列表

任务列表的语法:

- [ ] 未勾选
- [x] 已勾选

任务列表以-+空格开头,由 [+空格/x+] 组成,x可以小写,也可以大写,有些编辑器可能不支持大写,所以为避免解析错误,推荐使用小写的x,当方括号中的字符为空格时,复选框是未选中状态,为x时是选中状态。

锚点

锚点,也称为书签,用来标记文档的特定位置,使用锚点可以跳转到当前文档或其他文档中指定的标记位置

类似于HTML里的锚点定位,通过创建锚点链接,用户能够快速定位到目标内容。

锚点语法格式:

[锚点描述](#锚点名称)

简介