前言

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

标题

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

中标题,内容放在—上面

一级标题H1

二级标题H2

三级标题H3

四级标题H4

五级标题H5
六级标题,不能再小了H6
1
2
3
4
5
6
7
8
9
10
11
## 标题
大标题,内容放在===上面
===
中标题,内容放在---上面
---
# 一级标题H1
## 二级标题H2
### 三级标题H3
#### 四级标题H4
##### 五级标题H5
###### 六级标题,不能再小了H6

正文

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

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

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

也成功了。


强调

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

1
<u>下划线</u>  

这是高亮显示

1
这是`高亮显示`  

上标:X2,下标:O2

1
上标:X<sub>2</sub>,下标:O<sup>2</sup>  
    hello, i am ajioy! a Tab in head (行首放8个空格)
    something important here 

引用

块引用
换行内容

  • 可以加列表

嵌套引用

外层引用

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

第三级引用

第四级引用

1
2
3
4
5
> 第一层引用
> * 第一层引用加列表,行尾2个空格
> * 第一层引用加列表
>> 第二层引用
>>> 第三层引用,依次类推

列表

无序列表

  • c++
  • python
  • javascript
1
2
3
* c++
- python
+ javascript

有序列表

  1. apple
  2. orange
  3. banana
1
2
3
1. apple
2. orange
3. banana

嵌套列表

  • first
    • second
      1. third
      2. third another
  • another one
    • great
      • fantastic
1
2
3
4
5
6
7
8
* first
* second
1. third
2. third another
* another one
* great
* fantastic

任务待办

  • 跑步
  • 买日常用品
  • 数据备份
  • 买菜做饭
1
2
3
4
5
任务待办
- [x] 跑步
- [x] 买日常用品
- [ ] 数据备份
- [ ] 买菜做饭

排版

空格

  • 不断行的空格 &nbsp; 或 &#160; 1/4 中文
  • 半角的空格 &ensp; 或 &#8194; 半个中文,1字符
  • 全角的空格 &emsp; 或 &#8195; 1个中文,2字符
1
2
3
4
&nbsp; ---> 牛皮的spa
&ensp; ---> 嗯,很舒服的spa
&emsp; ---> 摁(第四声),很大力的spa

分隔符




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

对齐

left

center

right

1
2
3
<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不支持

1
2
3
4
<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>

折叠

点我展开折叠

说点什么

  • 这是个列表
  • 确实是个列表,你真棒

一个小小的引用块🤔

1
2
3
4
5
6
7
8
9
10
11
12
13

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

### 说点什么

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

> 一个小小的引用块🤔

</details>

注意:目前只有github支持


图片

普通图片

pic

1
![pic](http://ajioy.cn/img/avatar.jpg "my pic")

带链接的图片(方法一,图片+链接)

pic

1
[![pic](http://ajioy.cn/img/avatar.jpg "my pic")](https://blog.csdn.net/ajioy)

带链接的图片(方法二,引用式)

![blog]
[blog]: http://ajioy.cn/img/avatar.jpg “my pic”

1
2
[![blog]](https://blog.csdn.net/ajioy)
[blog]: http://ajioy.cn/img/avatar.jpg "my pic"

大部分平台不支持

内部引用图片

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

控制图片大小及对齐方式

  • 方法一,平台通用的标签法

    1
    2
    3
    <div align="right">
    <img src="http://ajioy.cn/img/avatar.jpg" width="400px" height="400px">
    </div>
  • 方法二,部分平台支持
    ![pic](url),其中url后面加个空格,再=WIDTHxHEIGHT,HEIGHT可以省略。
    如 (http://url.jpg =400x400)

    1
    2
    ![pic](http://ajioy.cn/img/avatar.jpg =400x400)
    ![pic](http://ajioy.cn/img/avatar.jpg =400x)
  • 方法三,简书等部分平台支持

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

链接

行内式

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

1
2
3
4
5
直接链接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”

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

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


表格

序号 名字 分数
101 ajioy 99.82
102 scotte 98.12
103 bot 97.23
1
2
3
4
5
| 序号 | 名字   | 分数  |
| :--: | :--- | ---: |
| 101 | ajioy | 99.82 |
| 102 | scotte | 98.12 |
| 103 | bot | 97.23 |

:— 左对齐,冒号在左边
—: 右对齐,冒号在右边
:–: 居中对齐,冒号两边

复杂表格

目标 计划 说明
晨跑
  1. 6:30起床
  2. 热身10分钟
  3. 平地跑5公里,约35分钟
  4. 跑后拉伸5分钟
  • 下雨天不跑
  • 上医院不跑
  • 周末不跑
健康生活 作息6:30-23:00,睡足7.5小时
  • 争取22:30入睡
  • 周末分别顺延30分钟
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<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>


代码

1
2
def add(a, b):      # python
return a + b
1
sudo apt-get install autojump # bash
1
2
3
4
int main()
{
printf("hello,ajioy"); // cpp
}

diff

1
2
3
4
5
+ add
- delete
~ modify?
! what's this
# i don't known

脚注

方法一

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

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

方法二

整个句子作脚注。^[这里就是脚注内容,默认会生成脚注序号]
有道云支持。

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

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

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

我要解释一个名词1

1: Footnote content goes here

视频

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

1
<iframe src="//player.bilibili.com/player.html?aid=57373164&cid=100164001&page=1" width="600" height="300" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
> github不支持,用带链接的GIF代替

音频

1
2
3
<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

github不支持


LaTeX公式

todo
访问 MathJax


流程图

todo
语法参考:流程图语法参考


序列图

todo
语法参考:序列图语法参考


甘特图

todo
语法参考:甘特图语法参考


最后是脚注的解释内容

[^1]:pumas are large cat-like animals which are found in America.
[^2]:ruby is a script lanuage;


-from my evernote
(全文完)

本文历史

  • 2019年8月6日 完成初稿。