前言
学习目的
1) 更方便做笔记
2) 做完的笔记可以直接在博客上发布
学习路线
1) 在哔哩哔哩上查找Markdown学习视频
2) 边练习边总结
3) 学习笔记
资料定位
以后需要用时可直接查看指令。
一 简介
1.1 基本信息
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为.md
, .markdown
。
Markdown能被用来撰写电子书,如:Gitbook;还能用来写博客。
1.2 编辑器
有在线编辑器以及客户端编辑器软件,如Typora。
二 基本指令
2.1 标题
快使用井号#
。
指令:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
2.2 段落
Markdown段落没有特殊格式,直接编写文字即可,段落的换行是使用两个以上空格加上回车或者在段落后面空一行也可以表示重新开始一个段落。
2.3 字体
用星号*
或者底线_
指令:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
2.4 分割线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
指令:
***
* * *
*****
- - -
----------
2.5 删除线
文字两端加上两个波浪线~~
指令:
~~删掉我吧~~
2.6 下划线
下划线可以通过HTML的u
标签来实现
指令:
我是谁
2.7 脚注
脚注是谁?是,对文本的补充
指令:
[^我是脚注]
举个栗子:
我是谁[^1]
[^1]: 我是脚注
2.8 列表
A 无序列表
无序列表使用星号*
、加号+
或是减号-
作为列表标记:
指令:
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
- 第一项
- 第二项
- 第三项
B 有序列表
有序列表使用数字并加上点号.
来表示,如:
指令:
1. 第一项
2. 第二项
3. 第三项
C 列表嵌套
列表嵌套只需在子列表中的选项添加四个空格即可:
指令:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
实际操作时,更简单,和WORD有点相似。
2.9 区块
区块引用是在段落开头使用西文半角大于号 >
,然后后面紧跟一个空格符号:
> 我是谁
> 菜花,我是区块啊!
A 区块嵌套
另外区块是可以嵌套的,一个 >
符号是最外层,两个>
符号是第一层嵌套,以此类推:
> 区块
> > 区块儿
> > > 区块孙
B 区块中用列表
区块中使用列表实例如下:
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
C 列表中用区块
如果要在列表项目内放进区块,那么就需要在>
前添加四个空格的缩进。
* 第一项
> 我是区块
> 好巧,我也是
* 第二项
实际列表应用也没写的这么复杂,水到渠成。
2.10 代码
如果是段落上的一个函数或片段的代码可以用反引号`把它包起来。(惊了,我没法用代码的形式把反引号包起来)
这个`我是谁`有病
A 代码区块
可以有三种方法表示代码区块,且可以指定一种语言(也可以不指定)
方法一: 代码区块使用 4 个空格
方法二: 一个制表符(Tab 键)或者用。
方法三: 用三个反引号 ``` 包裹一段代码
2.10 链接
链接使用方法如下:
[链接名称](链接地址)
或者
<链接地址>
高级链接
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
[runoob]: http://www.runoob.com/
2.11 图片
Markdown在使用网络图片时,一般是右键复制网络图片,然后直接粘贴到Markdown编辑器中即可完成图片的导入。
A 图片语法:
[图片上传失败...(image-5f17e7-1583244273246)]
[图片上传失败...(image-c7bb0d-1583244273247)]
1) 开头一个感叹号 !
2)接着一个方括号,里面放上图片的替代文字
3) 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
B 像网址那样对图片网址使用变量
这个链接用 1 作为网址变量 [RUNOOB][1].
然后在文档的结尾为变量赋值(网址)
[1]: http://static.runoob.com/images/runoob-logo.png
C 图片的高度和宽度
Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 img 标签。
语法格式:
2.12 表格
Markdown 制作表格使用 |
来分隔不同的单元格,使用 -
来分隔表头和其他行。(然而的Markdown还没有表格格式)
A 语法格式:
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
B 对齐方式
-:
设置内容和标题栏居右对齐。:-
设置内容和标题栏居左对齐。:-:
设置内容和标题栏居中对齐。
2.13 公式
当你需要在编辑器中插入数学公式时,可以使用两个美元符$$
包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。
【注】:
使用MathType编辑好公式后,可以直接转换为LaTex代码
三 技巧
3.1 支持的HTML元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:
等
3.2 转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠\
转义特殊字符:
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
3.3 markdown首行缩进
A 问题来源
将Typora中编写的md文件导入到中时,文档首行不缩进。
B 解决方法
(不要忘记后面的分号)
半方大的空白: 或
全方大的空白: 或
不断行的空白格: 或
3.4 字体样式与颜色
A 问题来源
看到缩进,就想到字体和颜色问题
B 解决方法
使用HTML的方法。
1) 字体设置
关键词为face
我是黑体
我是宋体
引号中可填:宋体、黑体、仿宋、微软雅黑、华文彩云……
2) 大小设置
关键词为size
我的大小是3
我的大小是4
3) 颜色设置
关键词为color
我是红色的
我是紫色的
可以填写数字,也可以填写颜色的单词。
3.5 Typora导出PDF文件时不全
A 问题来源
利用Typora导出pdf文件时,有时出现无法导出的问题
B 解决方法
当typora导出PDF或HTML时碰到非代码块中的一对尖括号便会停止。因此需要把非代码块部分的一对尖括号去掉。
代码块是什么:
这是代码块
非代码块容易被忽略的有:两个反引号中的,像这样这样的
尖括号是什么:
这是一对尖括号:< >
参考资料
[1] 菜鸟教程RUNOOB.COM. Markdown教程. RUNOOB.COM. 2020. https://www.runoob.com/markdown/md-title.html
[2] 酒石酸菌. Typora编辑器——书写即为美学. 哔哩哔哩. 2018. https://www.bilibili.com/video/av20190823/?spm_id_from=333.788.videocard.0
[3] 寸草心2130. markdown实现首行缩进、空格的两种方法. CSDN博客. 2019. https://blog.csdn.net/qq_35531549/article/details/90292957
[4] Vinson.【经验总结-markdown】markdown字体和颜色设置. 博客园cnblogs. 2019. https://www.cnblogs.com/vinnson/p/10845137.html
[5] 孤木不成林. typora导出pdf或HTML不全的解决办法. CSDN博客. 2018. https://blog.csdn.net/ychhh/article/details/84790905