【学习总结】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、字符转义

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

1265453-20180201150952359-1217181945.png

扩展语法如下:

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、表格

单元格和表头

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

例如:(此处最好空一行不然不显示了)

nameage
LearnShare12
Mike32

为了美观可以这样:(显示效果无差别,只是Markdown编写的时候看着更规整)

nameage
LearnShare12
Mike32
对齐

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

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

例如:

leftcenterright
aaaabbbbbbccccc
abc

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

插入其他内容:

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

例如:

nameageblog
LearnShare12LearnShare
Mike32Mike

4、Task List

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

例如:

  • [ ] Eat
  • [x] Code
    - [x] HTML
    - [x] CSS
    - [x] JavaScript
  • [ ] Sleep

后续

后续部分

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

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


The End

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

<div><something >

转载于:https://www.cnblogs.com/anliux/p/8010693.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值