Markdown简要用法
粗斜体
代码:
1 | *斜体* |
显示效果:
- 斜体
- 粗体
- 粗斜体
标题
代码:
1 | # 一级标题 |
显示效果:
分隔符
说明:
一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
代码:
1 | --- |
显示效果(效果都一样):
超链接
行内式
代码:
1 | [威威的博客](https://ailvv.github.io) |
显示效果:
参考式
代码:
1 | [威威的博客][xx] |
显示效果:
简短的自动链接形式
说明:
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。
代码:
1 | <http://ailvv.github.io> |
显示效果:
列表
无序列表
说明:
使用 *,+,- 表示无序列表。
代码:
1 | * 无序列表项1 |
显示效果:
- 无序列表项1
- 无序列表项2
- 无序列表项1
- 无序列表项2
- 无序列表项1
- 无序列表项2
有序列表
有序列表则使用数字接着一个英文句点。
代码:
1 | 1. 有序列表项 一 |
显示效果:
- 有序列表项 一
- 有序列表项 二
- 有序列表项 三
定义型列表
定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
代码:
1 | Markdown |
显示效果:
Markdown
: 轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格
代码块
: 这是代码块的定义
列表缩进
说明:
列表项目标记通常是放在最左边,但也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
代码:
1 | * 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 |
显示效果:
- 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
- 那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
引用
说明:
引用需要在被引用的文本前加上>符号。
普通引用
代码:
1 | >hahaha |
显示效果:
hahaha
yyyyyyy
yeyeyeye
引用的多层嵌套
代码:
1 | >hahaha |
显示效果:
hahaha
yyyyyyy
yeyeyeye
图片
说明:
图片的创建方式与超链接相似,和超链接一样,有两种写法,即行内式和参考式写法。
语法中:
- Alt:当图片因某些原因不能显示,就用Alt文字来代替图片
- Title:鼠标悬停与图片上时出现的文字
- Alt 和 Title 都不是必须的,可省略。
行内式
说明:
![图片Alt](图片地址 “图片Title”)
代码:
1 | ![美丽天空](https://wx1.sinaimg.cn/mw690/006CCgKCgy1g0uqgq5mmxj31400u0wj2.jpg "美丽天空") |
显示效果:
参考式
说明:
在文档要插入图片的地方写 ![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”
代码:
1 | ![美丽天空][sky] |
显示效果:
注脚
说明:
在需要添加注脚的文字后加上脚注名字注脚名字,称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。
注意:
经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。
代码:
1 | Markdown[^1]支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来,Markdown就会自动把它转成链接。 |
显示效果:
Markdown1支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来,Markdown就会自动把它转成链接。
LaTeX 公式
$表示行内公式:
代码:
1 | 质能守恒方程可以用一个很简洁的方程式 $$E=mc^2$$ 来表达。 |
显示效果:
质能守恒方程可以用一个很简洁的方程式 来表达。
$表示整行公式:
代码:
1 | $$ |
显示效果:
注意:
若选择Typora进行编辑博文,可选定文章部分内容后再选定左上角段落中的公式块即可生成公式- *更多公式使用方法可访问MathJax或数学公式
- Hexo 默认是不支持LaTeX公式语法的,需要添加支持插件,可参考 hexo-math解决方案1 或 hexo-math解决方案2
流程图
操作模块语法
- start:开始
- end:结束
- opration:普通操作块
- condition:判断块
- subroutine:子任务块
- inputoutput:输入输出块
代码:
```flow
st=>start: 开始
e=>end: 结束
op=>operation: 操作
sub=>subroutine: 子程序
cond=>condition: 是或者不是?
io=>inputoutput: 输出
st(right)->op->cond
cond(yes)->io(right)->e
cond(no)->sub(right)->op
```
显示效果:
1 | st=>start: 开始 |
注意:
Hexo 默认是不支持流程图的 Markdown 语法的,需要添加支持:npm install —save hexo-filter-flowchart
表格
说明:
- 绘制表格格式如下,| 控制分列,- 控制分行,: 控制对齐方式。
- :——为居左
- :——:或——-为居中
- ——:为居右
代码:
1 | | Item | Value | Qty | |
显示效果:
Item | Value | Qty |
---|---|---|
Computer | 1600 USD | 5 |
Phone | 12 USD | 12 |
Pipe | 1 USD | 234 |
代码
说明:
- 代码分为行内代码和代码块
- 行内代码使用 `代码`标识,可嵌入文字中
代码块使用4个空格或```标识
注意:
缩进式代码插入前方须有空行
行内代码:
说明:
用`囊括内容
显示效果:
scanf()
代码块:
说明:
用```囊括内容。
代码:
```
include
int main(void)
{
printf(“Hello world\n”);
}
```
显示效果:
1 | include <stdio.h> |
缩进式代码块:
代码:
include
int main(void)
{
printf(“Hello world\n”);
}
显示效果:
include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
注意:缩进 4 个空格或是 1 个制表符再写代码,一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)
HTML 原始码插入:
说明:
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:
代码:
1 | {% raw %} |
显示效果:
值班人员 | 星期一 | 星期二 | 星期三 |
---|---|---|---|
李强 | 张明 | 王平 |
工具推荐
- 在线编辑器
- 本地编辑器
- Typora
感谢
1. Markdown是一种纯文本标记语言 ↩