markdown教程有这么一篇就够了
前言
markdown已被越来越多的互联网厂商支持,如github、有道云、简书、CSDN等,默认都支持md语法。markdown真正做到了排版与文字分离,让你专注在内容本身。
标题
大标题,内容放在===上面
中标题,内容放在—上面
一级标题H1
二级标题H2
三级标题H3
四级标题H4
五级标题H5
六级标题,不能再小了H6
1 | ## 标题 |
正文
正文,常规文本,不需要任何标识。回车键不能直接换行,只能用以下两种方式。
- 两个空格+回车
- 用< 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 | > 第一层引用 |
列表
无序列表
- c++
- python
- javascript
1 | * c++ |
有序列表
- apple
- orange
- banana
1 | 1. apple |
嵌套列表
- first
- second
- third
- third another
- second
- another one
- great
- fantastic
- great
1 | * first |
任务待办
- 跑步
- 买日常用品
- 数据备份
- 买菜做饭
1 | 任务待办 |
排版
空格
- 不断行的空格 或   1/4 中文
- 半角的空格   或   半个中文,1字符
- 全角的空格   或   1个中文,2字符
1 | ---> 牛皮的spa |
分隔符
三个减号,三个星号,三个下划线都可以作为分隔符
对齐
left
center
right
1 | <p align="left">left</p> |
字体
我是黑体字
我是华文彩云
color=#0099ff size=5 face=”黑体”
color=gray
Size:文本的尺寸大小,可能的值:从 1 到 7 的数字。浏览器默认值是 3
github不支持
1 | <font face="黑体">我是黑体字</font> |
折叠
1 |
|
注意:目前只有github支持
图片
普通图片
1 | ![pic](http://ajioy.cn/img/avatar.jpg "my 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 | [![blog]](https://blog.csdn.net/ajioy) |
大部分平台不支持
内部引用图片
1 | [![SMILE](_pics/smile.gif)](https://blog.csdn.net/ajioy) |
控制图片大小及对齐方式
方法一,平台通用的标签法
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 | 直接链接1 https://blog.csdn.net/ajioy |
参考式
[带标题链接][link]
[link]: https://blog.cdsn.net/ajioy “Blog”
1 | [带标题链接][link] |
参考式相对于行内式的优点是,可以在多个不同的位置引用同一个URL,图片也可以用此方式
表格
序号 | 名字 | 分数 |
---|---|---|
101 | ajioy | 99.82 |
102 | scotte | 98.12 |
103 | bot | 97.23 |
1 | | 序号 | 名字 | 分数 | |
:— 左对齐,冒号在左边
—: 右对齐,冒号在右边
:–: 居中对齐,冒号两边
复杂表格
目标 | 计划 | 说明 |
晨跑 |
|
|
健康生活 | 作息6:30-23:00,睡足7.5小时 |
|
1 | <table> |
代码
1 | def add(a, b): # python |
1 | sudo apt-get install autojump # bash |
1 | int main() |
diff
1 | + add |
脚注
方法一
句中作脚注,解释一个名词[^1],再解释一个[^2]。
脚注放在文章最下面,脚注可以直接放链接。
[^1]: 解释名词1
[^2]: https://www.google.com
1 | 句中作脚注,解释一个名词[^1],再解释一个[^2]。 |
方法二
整个句子作脚注。^[这里就是脚注内容,默认会生成脚注序号]有道云
支持。
1 | 整个句子作脚注。^[这里就是脚注内容,默认会生成脚注序号] |
github不支持以上两种方式,以下为替代方案
1 | 定义 |
我要解释一个名词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> |
音频
1 | <audio id="audio" controls="" preload="none"> |
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日 完成初稿。