Markdown

2021-01-30  本文已影响0人  陨落的小白

Markdown使用

一、介绍

考虑到周围不少同学不太了解markdown以及从未使用过markdown,这里对markdown进行一下介绍。我平时写公众号文章全部是使用markdown编写,之后使用相应的格式转换工具排版,比起word要方便很多(当然如果word用的很熟练的话自然是不比markdown差的,我就属于word用得不太利索的…)

markdown在平时的工作生活中有很多方便的使用场景,例如做笔记,进行项目记录,写报告等等。它可以让你暂时性忽略复杂的排版,仅仅从文章结构出发,通过一系列标记形成文本的结构,大家体验一下就知道他有多方便啦~

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

二、编辑器

由于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 属性文本](图片地址 "可选标题")

表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

语法格式如下:

|  表头1   | 表头2  |
|  ----  | ----  |
| 单元格1  | 单元格2 |
| 单元格3  | 单元格4 |

我们可以设置表格的对齐方式:

  1. -: 设置内容和标题栏居右对齐。
  2. :- 设置内容和标题栏居左对齐。
  3. :-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

常用技巧

支持的 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语法简洁、使用便捷。而且一般的编辑软件都有很好的用户图形界面,非常的好用,即便很久没有使用也能很快回忆起语法。

上一篇下一篇

猜你喜欢

热点阅读