markdown常用指令
markdown简介
markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为 .md, .markdown。
注意:Markdown使用#、+、*等符号来标记, 符号后面必须跟上至少1个空格才有效!且符号之间的字体与符号之间不能有空格。本文提到的指令如果需要空格(这里的空格指的是指令和包含的内容之间的空格)则会提醒读者,如果没有默认不注释。
markdown用途
Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。完全采用Markdown编辑器的博客平台有Ghost和Typecho。
用于编写说明文档,并且以"README.MD"的文件名保存在软件的目录下面。
除此之外,现在由于我们有了RStudio这样的神级编辑器,我们还可以快速将Markdown转化为演讲PPT、Word产品文档、LaTex论文甚至是用非常少量的代码完成最小可用原型。在数据科学领域,Markdown已经广泛使用,极大地推进了动态可重复性研究的历史进程。
markdown常用指令
1. 标题
一共有六级标题,一个井号(#)代表一级标题,两个井号(##) 代表二级标题,以此类推。
注:井号和标题之间需要有一个空格
一级标题和二级标题还可以分别使用 一个等号(=)和 一个减号(-) 号表示;
语法:
1-6个#+空格+标题名称
一级标题名称+换行+1个或多个 =
二级标题名称+换行+1个或多个 -
展示效果:
一级标题(用#表示)
一级标题(用=表示)
二级标题(用#表示)
二级标题(用-表示)
三级标题
四级标题
五级标题
六级标题
代码截图:
2.文本样式
- 字体加粗
字体加粗使用 两个星号(**) 或者 两个下划线(__) 表示。
语法:
**字体加粗**
__字体加粗__
展示效果:
字体加粗 - 斜体文本
斜体文本使用 一个星号(*) 或者 一个下划线(_)表示。
语法:
*斜体文本*
_斜体文本_
展示效果:
斜体文本 - 粗斜体
粗斜体使用 三个星号(***) 或者 三个下划线(___)表示。
语法:
***粗斜体***
___粗斜体___
效果展示:
粗斜体 - 高亮文本
标记文本使用两个等号(==)表示
语法:
==高亮文本==
效果展示:
高亮文本 - 删除文本
删除文本使用两个波浪号(~~)表示。
语法:
~~删除文本~~
效果展示:
删除文本 - 引用文本
引用文本使用一个大于号(>)表示。
语法:
>引用文本
效果展示:
引用文本
注:引用文本可嵌套,例如:
>最外层
> >内部第一层
> > >内部第二层
最外层
内部第一层
内部第二层
- 下划线
下划线使用html的<u>标签。
语法:
<u>下划线<u>
效果展示:
下划线.
- 插入链接
语法:
[描述](网址)或者
<网址>
方括号里放入描述,括号里放入链接的网址;第二种无法添加描述语言,而是直接显示链接网址。
例:
[csdn博客](https://blog.csdn.net/)
<https://blog.csdn.net/>
效果展示:
csdn博客
https://blog.csdn.net/
高级链接
通过变量设置一个链接,变量链接在文档末尾进行
这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址),不然无法正确解析
效果:
这个链接用 1 作为网址变量 Google
这个链接用 runoob 作为网址变量 Runoob - 插入图片
语法:
[alt 属性文本](地址)
带尺寸图片:[alt 属性文本](地址 =长x宽)
居中图片:[alt 属性文本](地址#pic_center)
居中带尺寸:[alt 属性文本](地址#pic_center=长x宽) - 插入代码
插入代码使用
```代码名称(c/c++等等)
内容
```
例如:
```cpp
#include
using namespace std;
int main(){
cout<<“hello world!”<<endl;
return 0;
}
```
效果展示:
#include <iostream>
using namespace std;
int main(){
cout<<"hello world!"<<endl;
return 0;
}
- 无序列表
无序列表使用减号(-)或者加号(+)或者星号(*)表示
注:不论是无序还是有序列表,特殊字符与内容之间都要有一个空格。
例:空格,空格,空格重要的事情说三遍
* 列表1
* 列表2
- 列表3
- 列表4
+ 列表5
+ 列表6
效果:
- 列表1
- 列表2
- 列表3
- 列表4
- 列表5
- 列表6
- 有序列表
有序列表使用数字加英文句号.组成。
注:句号和内容之间需要空格呀
例如:
1. 有序列表1
2. 有序列表2
效果:
1. 有序列表1
2. 有序列表2
8.分割线
使用三个以上的星号、减号、下划线创建一个分割线,行内不能有其他东西。星号、减号、下划线之间可以插入空格。
例如:
***
* * *
效果:
- 脚注
使用
[^脚注文本]
[^脚注文本]:脚注内容
例如:
这里使用一个脚注[^脚注例子]
[^脚注例子]:这里是说明文字
效果:
这里使用一个脚注1 - 表格
使用竖线(|)分割不同的单位元,使用减号(-)分隔表头和其他行。
表格对齐方式
-:右对齐
:- 左对齐
:-: 居中对齐
例如:
|表头|表头|表头|
|:------ | :------: | ------: |
| 左对齐 | 居中对齐 | 右对齐 |
| 左对齐 | 居中对齐 | 右对齐 |
注:减号可以多个;表头上方必须有一行空行,不然无法识别为表格(很重要)
效果:
表头 | 表头 | 表头 |
---|---|---|
左对齐 | 居中对齐 | 右对齐 |
左对齐 | 居中对齐 | 右对齐 |
- 其他
各种LateX数学公式,流程图等请参考其他文档。
这里是说明文字 ↩︎