Markdown使用
一、介绍
考虑到周围不少同学不太了解markdown以及从未使用过markdown,这里对markdown进行一下介绍。我平时写公众号文章全部是使用markdown编写,之后使用相应的格式转换工具排版,比起word要方便很多(当然如果word用的很熟练的话自然是不比markdown差的,我就属于word用得不太利索的…)
markdown在平时的工作生活中有很多方便的使用场景,例如做笔记,进行项目记录,写报告等等。它可以让你暂时性忽略复杂的排版,仅仅从文章结构出发,通过一系列标记形成文本的结构,大家体验一下就知道他有多方便啦~
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
- Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
- Markdown 编写的文档后缀为 .md, .markdown。
二、编辑器
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息, 如GitHub、Stack Exchange、OpenStreetMap 、SourceForge、CSDN论坛、简书等,甚至还能被使用来撰写电子书。
编写Markdown的编辑器有很多,比如Typora,Sublmie Text等。一些博客网站也支持Markdown编写比如CSDN、简书等等,而且还有预览功能,Sublime Text好像没有预览功能,对于一些新入手Markdown的童鞋来说还是选择有预览功能的编辑器比较好。不过CSDN在插入图片的时候好像会自动给你加上你博客账户的水印,如果单纯写Markdown文件,加上水印就不太好了,所以大家可以下载专用的编辑器,比如Typora,就像编代码一样使用哈哈哈哈。除此之外,一些编程软件的集成开发环境也支持Markdown的编写,比如JetBrains全家桶,可以用来写帮助文档或则接口文档。
三、使用方法
标题
Markdown有两种标题表示方法:
(1)使用 = 和 - 标记以及和二级标题
用我来表示一级标题
=================
用我来表示二级标题
-----------------
(2)使用#标记
使用 #
号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
用这种方式表示标题可以快速生成文章结构图,例如(下图右边)
段落
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。当然也可以在段落后面使用一个空行来表示重新开始一个段落。
从上图可以看到两个换行方式,第一行的换行就是两个空格加回车的换行方式,后面会有一个竖直向下的箭头;第二行就是使用一个空行表示重新开始的一个段落。其实直接回车也可以的哈哈哈哈。
字体
Markdown 可以使用以下几种字体:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
是不是感觉很简单呢。
删除线和下划线
删除线可以用~~
来标记,下划线可以使用html的<u>
标签来标记:
Markdown删除线
~~Markdown删除线~~
Markdown下划线
<u>Markdown下划线</u>
脚注
脚注是对文本的补充说明。Markdown 脚注的格式如下:
[^要注明的文本]
示例:
创建脚注格式[^ 脚注]
[^ 脚注]: 这是一个脚注
当把鼠标移动到脚注上时,就会显示出脚注信息。
分割线
Markdown可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
*****
- - -
----------
列表
Markdown 支持有序列表和无序列表:
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:
下面是列表
* 列表第一项
* 列表第二项
* 列表第三项
+ 列表第1.1项
+ 列表第2.2项
+ 列表第3.3项
- 列表第one项
- 列表第two项
- 列表第three项
可以发现列表都是自带缩进的。
有序列表使用数字并加上 . 号来表示,如:
hello
1. Firstly
2. Secondly
3. Thirdly
列表嵌套
列表嵌套只需在子列表中的选项前面添加四个空格即可:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
区块
Markdown 区块引用是在段落开头使用>
符号 ,然后后面紧跟一个空格符号:
下面是区块
> 天长地久有时尽,此恨绵绵无绝期。
>
> 一个普通的改变也能改变普通。
>
> 我本将心向明月,奈何明月照沟渠
另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
> 天长地久有时尽,此恨绵绵无绝期
> > 一个普通的改变也能改变普通
> > > 我本将心向明月,奈何明月照沟渠
同样在列表中可以使用区块,在区块中也可以使用列表,这里就不再举例了,大家可以尝试一下。
代码
如果是段落上的一个函数或片段的代码可以用反引号(`)把它包起来,例如:
`System.out.println("hello, World");`
代码区块
代码区块使用 4 个空格或者一个制表符(Tab 键)或者使用三个反引号(`)把代码上下包起来:
```
#include <iostream>
int main() {
printf("hello,world");
system("pause");
return 0;
}
```
链接
[链接名称](链接地址)
或者
<链接地址>
实例:
这是一个链接[西南大学](http://swu.edu.cn)
<http://swu.edu.cn>
Markdown还有一种高级链接方式,就是可以通过变量来设置一个链接,变量赋值在文档末尾进行。这个就不再详细讲了哈,大家感兴趣可以百度一下。
插入图片
Markdown插入图片也有专门的语法,但是一般都是直接把图片复制粘贴进编辑器即可,也可以直接截图粘贴进来,然后改一下图片名称即可。至于具体的语法就不在详细的讲了。
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
- 开头一个感叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
表格
Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
语法格式如下:
| 表头1 | 表头2 |
| ---- | ---- |
| 单元格1 | 单元格2 |
| 单元格3 | 单元格4 |
我们可以设置表格的对齐方式:
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
常用技巧
支持的 HTML 元素:
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
转义字符:
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符。Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
公式:
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
熟练的话,用markdown敲公式可快了
除了上面讲的内容之外,Markdown还可以绘制画流程图、时序图(顺序图)、甘特图等图形。是不是感觉很不可思议。感兴趣的小伙伴可以在网上找一找如何绘制图形。
四、语法总结
Markdown语法 | 详解 |
---|---|
* | 标记斜体 |
** | 标记粗体文字 |
# 一级标题 | "#"后需加空格 |
## 二级标题 | 以此类推三级标题为三个“#” |
[链接](URL地址) | “[]”间为显示的超文本 |
![图片](图片地址) | “[]”间为图片名 |
> 引用 | ">"后需加空格 |
* 无序列表 | “*” 后需加空格 |
1. 有序列表 | 数字后需加"." |
``` | 标记代码块 |
Markdown语法简洁、使用便捷。而且一般的编辑软件都有很好的用户图形界面,非常的好用,即便很久没有使用也能很快回忆起语法。