markdown语法一览

最新推荐文章于 2024-07-08 13:26:03 发布

ajioy

最新推荐文章于 2024-07-08 13:26:03 发布

阅读量2k

点赞数 5

分类专栏： Else 文章标签： markdown tools

本文链接：https://blog.csdn.net/ajioy/article/details/98470086

版权

Else 专栏收录该内容

9 篇文章 0 订阅

订阅专栏

前言

markdown已被越来越多的互联网厂商支持，github、有道云、简书、CSDN等，默认都支持md语法，因为实在是太方便了，真正做到了排版与文字分离，让你专注在文字本身。

标题

大标题，内容放在===上面

中标题，内容放在—上面

一级标题H1

二级标题H2

三级标题H3

四级标题H4

五级标题H5

六级标题，不能再小了H6

## 标题
大标题，内容放在===上面
===
中标题，内容放在---上面
---
# 一级标题H1
## 二级标题H2
### 三级标题H3
#### 四级标题H4
##### 五级标题H5
###### 六级标题，不能再小了H6

正文

正文，常规文本，不需要任何标识。回车键不能直接换行，只能用以下两种方式。

两个空格+回车
用< br>或< br/>

这是个用例，我要换行了。
成功换行。
另一种方式换行。

也成功了。

强调

两个*加粗
两个_加粗
一个星号斜体
一个下划线斜体
~~两个~删除线~~
三个星号是粗斜体
下划线

<u>下划线</u>

这是高亮显示

这是`高亮显示`

上标：X₂，下标：O²

上标：X<sub>2</sub>，下标：O<sup>2</sup>

    hello, i am ajioy! a Tab in head (行首放8个空格)
    something important here

引用

块引用
换行内容

可以加列表

嵌套引用

外层引用

内层引用
还可以嵌套加粗，斜体等

第三级引用

第四级引用

> 第一层引用
> * 第一层引用加列表，行尾2个空格  
> * 第一层引用加列表  
>> 第二层引用
>>> 第三层引用，依次类推

列表

无序列表

python

javascript

* c++
- python
+ javascript

有序列表

apple
orange
banana

1. apple
2. orange
3. banana

嵌套列表

first
- second
  1. third
  2. third another
another one
- great
  - fantastic

* first
  * second
    1. third
    2. third another
* another one
  * great
    * fantastic

任务待办

跑步
买日常用品
数据备份
买菜做饭

任务待办
- [x] 跑步
- [x] 买日常用品
- [ ] 数据备份
- [ ] 买菜做饭

排版

空格

不断行的空格或 1/4 中文
半角的空格或半个中文，1字符
全角的空格或 1个中文，2字符

&nbsp; ---> 牛皮的spa
&ensp; ---> 嗯，很舒服的spa
&emsp; ---> 摁（第四声），很大力的spa

分隔符

三个减号，三个星号，三个下划线都可以作为分隔符

对齐

left

center

right

<p align="left">left</p>  
<p align="center">center</p>  
<p align="right">right</p>

字体

我是黑体字
我是华文彩云
color=#0099ff size=5 face=“黑体”
color=gray

Size：文本的尺寸大小，可能的值：从 1 到 7 的数字。浏览器默认值是 3
github不支持

<font face="黑体">我是黑体字</font>  
<font face="STCAIYUN">我是华文彩云</font>  
<font color=#0099ff size=7 face="黑体">color=#0099ff size=72 face="黑体"</font>  
<font color=gray size=4>color=gray</font>

折叠

<details>
<summary>点我展开折叠</summary>

### 说点什么

- 这是个列表
- 确实是个列表，你真棒  

> 一个小小的引用块?  

</details>

注意：目前只有github支持

图片

普通图片

![pic](https://i-blog.csdnimg.cn/blog_migrate/27ad4aa861ce2d0f5434f376a8e8a7e4.gif)

带链接的图片（方法一，图片+链接）

[![pic](https://profile.csdnimg.cn/6/3/D/1_ajioy.jpg "my pic")](https://blog.csdn.net/ajioy)

带链接的图片（方法二，引用式）

[[外链图片转存失败(img-hgovg1Xn-1565066643798)(https://blog.csdn.net/ajioy)]
[blog]: https://profile.csdnimg.cn/6/3/D/1_ajioy “my pic”

[![blog]](https://blog.csdn.net/ajioy)
[blog]: https://profile.csdnimg.cn/6/3/D/1_ajioy.jpg "my pic"

大部分平台不支持

内部引用图片

[![SMILE](_pics/smile.gif)](https://blog.csdn.net/ajioy)
其中SMILE是标题，_pics是md文件所在目录下的子目录，也是图片所在地，smile.gif则是图片名称

控制图片大小及对齐方式

方法一，平台通用的标签法

<div align="right">
<img src="https://profile.csdnimg.cn/6/3/D/1_ajioy.jpg" width="400px" height="300px">
</div>

方法二，部分平台支持
![pic](url)，其中url后面加个空格，再=WIDTHxHEIGHT，HEIGHT可以省略。
如 (http://url.jpg =400x300)

![pic](https://profile.csdnimg.cn/6/3/D/1_ajioy.jpg 400x300)
![pic](https://profile.csdnimg.cn/6/3/D/1_ajioy.jjp =400x)

方法三，简书等部分平台支持

![pic](url)的基础上加上{:height="300px" width="300px"}

链接

行内式

直接链接1 https://blog.csdn.net/ajioy
直接链接2 https://blog.csdn.net/ajioy
带标题链接
 带标题链接且鼠标悬停

直接链接1 https://blog.csdn.net/ajioy  
直接链接2 <https://blog.csdn.net/ajioy>  
[带标题链接](https://github.com/ajioy)  
[带标题链接且鼠标悬停](https://blog.csdn.net/ajioy "go to my blog")

参考式

[带标题链接][link]
[link]: https://blog.cdsn.net/ajioy “Blog”

[带标题链接][link]
[link]: https://blog.cdsn.net/ajioy "Blog"

参考式相对于行内式的优点是，可以在多个不同的位置引用同一个URL，图片也可以用此方式

---

## 表格
| 序号 | 名字   | 分数  |
| :--: | :---   | ---:  |
| 101  | ajioy  | 99.82 |
| 102  | scotte | 98.12 |
| 103  | bot    | 97.23 |

序号	名字	分数
101	ajioy	99.82
102	scotte	98.12
103	bot	97.23

> :--- 左对齐，冒号在左边  
> ---: 右对齐，冒号在右边  
> :--: 居中对齐，冒号两边  

复杂表格  

<table>
<tr>
<td>目标</td>
<td>计划</td>
<td>说明</td>
</tr>
<tr>
<td>晨跑</td>
<td><ol>
<li>6:30起床</li>
<li>热身10分钟</li>
<li>平地跑5公里，约35分钟</li>
<li>跑后拉伸5分钟</li>
</ol></td>
<td><ul>
<li>下雨天不跑</li>
<li>上医院不跑</li>
<li>周末不跑</li>
</ul></td>
</tr>
<tr>
<td>健康生活</td>
<td>作息6:30-23:00，睡足7.5小时</td>
<td><ul>
<li>争取22:30入睡</li>
<li>周末分别顺延30分钟</li>
</ul></td>
</tr>
</table>

目标	计划	说明
晨跑	6:30起床热身10分钟平地跑5公里，约35分钟跑后拉伸5分钟	下雨天不跑上医院不跑周末不跑
健康生活	作息6:30-23:00，睡足7.5小时	争取22:30入睡周末分别顺延30分钟




---

## 代码
```python
def add(a, b):      // python
    return a + b

sudo apt-get install autojump # bash

int main()
{
    printf("hello,ajioy"); // cpp
}

diff

+ add
- delete
~ modify?
! what's this
# i don't known

脚注

方法一

句中作脚注，解释一个名词¹，再解释一个²。
脚注放在文章最下面，脚注可以直接放链接。

句中作脚注，解释一个名词[^1]，再解释一个[^2]。  
脚注放在文章最下面，脚注可以直接放链接。
[^1]: 解释名词1  
[^2]: https://www.google.com

方法二

整个句子作脚注。³
有道云支持。

整个句子作脚注。^[这里就是脚注内容，默认会生成脚注序号]

github不支持以上两种方式，以下为替代方案

定义
<a name="myfootnote1">1</a>: Footnote content goes here
引用
<sup>[1](#myfootnote1)</sup>

我要解释一个名词¹

1: Footnote content goes here

视频

以B站为例，点分享按钮，复制嵌入代码，粘贴到md文件即可，其他网站类似。

```html ``` > github不支持，用带链接的GIF代替

音频

<audio id="audio" controls="" preload="none">
<source id="mp3" src="http://yourmusicurl.mp3">
</audio>

github不支持

地图

以百度地图为例，
访问API自定义地图 http://api.map.baidu.com/lbsapi/creatmap/index.html

设置好地点、文字、路线、标记后，点获取代码，复制代码，直接放在md文件，或将代码存放在map.html文件，同一目录下，再引入markdown