markdown终极指南

发布时间 2023-07-01 18:11:54作者: heart-z

markdown 是我一直在用的一种语法,本文想把他的各个方面的特性系统的介绍一下,方便去做一些查阅和学习。

介绍

  • Markdown 易于阅读,方便创作 web 文档,利于各平台无缝分发。
  • Markdown 语法灵感最大的来源还是纯文本 email 的格式,完全由标点符号标签组成的纯文本。
  • Markdown 文件应该以纯文本形式原样发布,不应该包含标记标签和格式化指令。

语法

真正的 markdown 语法很简单

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题  <!--最多6级标题-->

任务

- [ ] 任务一 未做任务 `- + 空格 + [ ]`
- [x] 任务二 已做任务 `- + 空格 + [x]`

字体

*斜体*
**粗体**
***加粗斜体***
~~删除线~~
==背景高亮==

斜体
粗体
加粗斜体
删除线
背景高亮

字号和颜色

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=gray size=5>gray</font>
<font color=#00ffff size=3>null</font>

我是黑体字
我是微软雅黑
我是华文彩云
黑体
gray
null

参考链接

行内式

欢迎阅读 [hearted]https://www.cnblogs.com/zjj666 "zjj666")

欢迎阅读 [hearted] https://www.cnblogs.com/zjj666 "zjj666")

参考式

参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]: 链接地址。

如果链接文字本身可以做为链接标记,你也可以写成[链接文字][]
[链接文字]:链接地址的形式,见代码的最后一行。

我经常去的几个网站[Google][1]、[Leanote][2]。

[1]:http://www.google.com 
[2]:http://www.leanote.com

本文参考的几个网站jianshuLeanote

注脚

语法说明:

在需要添加注脚的文字后加上脚注名字[^注脚名字], 称为加注。然后在文本的任意位置 (一般在最后)添加脚注,脚注前必须有对应的脚注名字。

注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经 Markdown 转换后,也会自动归类到文章的最后。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperText Markup Language 超文本标记语言

使用 Markdown1可以效率的书写文档, 直接转换成 HTML2

列表

无序列表

使用 * ,+,- 表示无序列表。
代码:

* 无序列表项 一
+ 无序列表项 二
- 无序列表项 三
  • 无序列表项一
  • 无序列表项二
  • 无序列表项三

有序列表

有序列表则使用数字接着一个英文句点。

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三
  1. 有序列表项一
  2. 有序列表项二
  3. 有序列表项三

图像

图像这个真的坑很多,用法很简单

语法中图片 Alt 的意思是如果图片因为某些原因不能显示,就用定义的图片 Alt 文字来代替图片。图片 Title 则和链接中的 Title 一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。

<center>  <!--开始居中对齐-->

![GitHub set up](http://zh.mweb.im/asset/img/set-up-git.gif "图片Title")
格式: ![图片Alt](图片地址 "图片Title")
</center> <!--结束居中对齐-->

GitHub set up
格式: 图片 Alt

多级引用

引用需要在被引用的文本前加上>符号和空格,允许多层嵌套

> 请问 Markdwon 怎么用? - 小白
>> 自己看教程! - 愤青
>>> 教程在哪? - 小白

请问 Markdwon 怎么用? - 小白

自己看教程! - 愤青

教程在哪? - 小白

特殊字符

前往此处查看

换行,空格符

前往[此处][4]查看
[4]: https://www.cnblogs.com/zjj666/articles/14281132.html