【学习总结】Markdown 使用的正确姿势

参考资料：

1、段落与换行

段落的前后必须是空行：相邻两行文本，如果中间没有空行 会显示在一行中（换行符被转换为空格）
注：在GitHub中是这样，博客园不是。

段落内换行：

2、标题

一种是====和---- （Setext 形式，只有两级标题，博客园不支持）
一种是## （atx 形式，可以两边对称井号或只在左边）
常用井号

例如：
H1

H2

3、引用

单行：行前加>
多行：每行加> 或只在第一行加后面相邻行自动加入，如需换行，行尾加两个空格或加一行空引用
嵌套：
注：博客园中表现并非如此,比如换行不加>，加>换行根本无效啊……

例如：

这是单行引用

这是多行引用
（如下一行这样可以空一行）

这是嵌套引用

这是嵌套引用

4、列表

无序列表：行首写 * 或 + 或 -，格式为“符号 空格”
有序列表：行首写，格式为“数字+(此处空格).(空格)+后面的内容”
嵌套列表：主列表换行后缩进后加无序列表符号或有序列表符号都可以，具体如下面的例子
如需在行前显示数字和“.”：数字. 来取消显示为列表

例如：

  • 这是无序列表一
  • 这是无序列表二
  • 这是无序列表三
  1. 有序列表以数字和 . 开始；
  2. 数字的序列并不会影响生成的列表序列；
  3. 但仍然推荐按照自然顺序（1.2.3...）编写。

1 . 主列表一(这里如果数字后不加空格，和上面的连着编号了；数字后加空格，重新开始编号)
+ 嵌套列表1.1
+ 嵌套列表1.2
2 . 主列表二
1. 2.1
2. 2.2

05. 按自己规定显示列表数字

5、代码

代码块：(然而并没有卵用，直接每行空格就引用为变色代码块了)

// Tab开头 Markdown // 四个空格开头 
<html> // Tab开头
<title>Markdown</title>
</html> // 四个空格开头

行内代码：通过 “两个点” code ，插入行内代码（两个点的点 ``` code `是 Tab 键上边、数字 1 键左侧的那个按键）
(这个很强)

<title>Markdown</title>

6、分割线

在行与行之间添加三个及以上的 * 、- 或 _ ，各个符号之间可以有多个空格
注：分割线与文字行需要空行否则不显示为分割线
注：下划线比较实在，画多长就显示多长……

例如：
第一行

第二行

第三行

第四行

7、超链接

行内链接： 格式为 link text
注：普通链接就够用了，后两个暂时感觉很鸡肋

① 普通链接：Google
② 指向本地文件的链接：icon.png
③ 包含 'title' 的链接：Google title 使用 ' 或 " 都是可以的

8、图片

插入图片的语法和插入超链接的语法基本一致，只是在最前面多一个 !。也分为行内式和参考式两种。

Markdown 不支持指定图片的显示大小，不过可以通过直接插入标签来指定相关属性（不太会）

一般是直接复制图片然后粘贴到编辑位置即可，暂时没有发现批量上传图片的方法，写作业时无法批量上传截图的痛记忆犹新。。

9、加粗vs斜体

1 . 使用 * * 或 _ _ 包括的文本会被转换为 ，通常表现为斜体：

例如：这是用来 演示 的 文本

2 . 使用 ** ** 或 __ __ 包括的文本会被转换为 ，通常表现为加粗：

例如：这是用来 演示 的 文本

3 . 用来包括文本的 * 或 _ 内侧不能有空白，否则 * 和 _ 将不会被转换（不同的实现会有不同的表现）：

例如： 这是用来 * 演示* 的 _文本 _

4 . 如果需要在文本中显示成对的 * 或 _，可以在符号前加入 反斜杠符号 “\” 即可：

例如： 这是用来 *演示* 的 _文本_

5 . *、**、_ 和 __ 都必须 成对使用 。

10、字符转义

原博没说明白，可能是转换符号原有功能的意思，比如反斜杠。贴图如下：

扩展语法如下：

1、删除线-前后加两个波浪符号

例如：这就是 删除线

2、代码块和语法高亮

代码块：单独成行的两组三个左上角点包含多行代码

例如：

<p>code here</p>
<p>code here</p>
<p>code here</p>

window.addEventListener('load', function() {
  console.log('window loaded');
});

当然，用缩进依然管用，不过代码多的话，用点点比较省事，少量代码可以缩进。不是一个空格，是tab
PS：缩进的方法，代码块不自动分开，换行无卵用。如需分开代码块，用点点的方法比较好。

<p>code here</p>
<p>code here</p>
<p>code here</p>


window.addEventListener('load', function() {
  console.log('window loaded');
});

语法高亮(然而似乎并没有卵用……和用以上的方法的效果无差别)

在上面的代码块语法基础上，在第一组 ``` 之后添加代码的语言，如 'javascript' 或 'js'，即可将代码标记为 JavaScript

例如：

window.addEventListener('load', function() {
  console.log('window loaded');
});

3、表格

单元格和表头

使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行：

例如：（此处最好空一行不然不显示了）

name age
LearnShare 12
Mike 32

为了美观可以这样：（显示效果无差别，只是Markdown编写的时候看着更规整）

name age
LearnShare 12
Mike 32

对齐

在表头下方的分隔线标记中加入 :，即可标记下方单元格内容的对齐方式：

:--- 代表左对齐
:--: 代表居中对齐
---: 代表右对齐

例如：

left center right
aaaa bbbbbb ccccc
a b c

如果不使用对齐标记，单元格中的内容默认左对齐；表头单元格中的内容会一直居中对齐（不同的实现可能会有不同表现）。

插入其他内容：

表格中可以插入其他 Markdown 中的行内标记：

例如：

name age blog
LearnShare 12 LearnShare
Mike 32 Mike

4、Task List

原博没有写任何说明文字，不太懂，感觉和前一部分的第4项，列表 的功能差不多。

例如：

后续

后续部分

其一，介绍了当前比较热门的Markdown编辑器
其二，介绍了转换为HTML，PDF，Word的格式转换。

此处不赘述，详情见原博。

The End

  • 注：其他---句子内的代码：

<div> ； <something >

posted @ 2017-12-09 10:17  anliux  阅读(1590)  评论(0)  编辑  收藏  举报