近段时间来,一直在Jupyter-Notebook上利用Markdown记录笔记,越发觉得Markdown之简便强大,故做此博客,记录下Markdown的一些语法,以备查阅复习之用。
- 此篇文章参考 Learning-Markdown一文,同时结合自己的学习使用经验写成。
- CSDN的博客系统的支持语法就是Markdown,用Markdown来写Markdown,怎么感觉有点怪怪的?
关于Markdown
简介
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成方便交流使用的 HTML (或者 XHTML)文档。
优点
- 基于纯文本,方便修改和共享
- 几乎可以在所有的文本编辑器中编写
- 有众多编程语言的实现,以及应用的扩展
- 在 CSDN、Github等网站有很好的应用
- 易转换为HTML文档或其他格式
- 兼容HTML语法,使得功能更为强大
场景
适合用来编写文档、记录笔记、撰写文章等文字记录工作
Markdown语法
转义符
- 为什么我把转义符放在第一位呢?因为下面这些都要加转义符啊。。。(用Markdown写Markdown,越想越别扭)
- 同许多语法一样,转义符用反斜杠 \ 表示,可以表示字符原来的含义(妈妈再也不用担心我瞎操作了( • ̀ω•́ )✧)
目录
语法: @[toc]
标题
一级标题: #
二级标题:##
以此类推
字体
加粗
- 语法:**字**
效果:字 - 语法:_字_
效果:字 - 语法:<b>字</b>
效果:字 - 语法:<strong>字</stong>
效果:字
倾斜
- 语法: *字*
效果:字 - 语法:<em>字</em>
效果:字
删除线
语法:~~体~~
效果: 体
其他设置(大小,颜色,字体等)
Markdown 语法对于字体的设定只有如上这些,要想修改字体的其他属性,如大小,字体格式,颜色等,可使用兼容的 HTML 语法。
语法: <font color=“blue” size=3 face=“华文行楷”>无问西东</font>
效果: 无问西东
段落
- 新的段落的前后必须是空行
- 如果需要在段落内换行,可以加入换行符<br>
语法:如果需要在<br>段落内换行,可以加入换行符
效果:如果需要在
段落内换行,可以加入换行符 - 在段落内换行也可在行末尾敲击两下空格,再使用Enter回车键换行
- 大部分情况下可使用Enter回车键换行
分割线
- 在一行内输入三个或更多相同字符(*,-,_任选一种),并且用空格隔开,且一行内不能有其他字符:
语法:
* * *
效果:
- 使用 HTML 语法 <hr>标签
语法:<hr>
效果:
列表
有序列表
语法:
\1. 无
\2. 问
\3. 西
\4. 东
效果:
- 无
- 问
- 西
- 东
无序列表
语法:
* 爱你所爱
* 行你所行
效果:
- 爱你所爱
- 行你所行
列表嵌套
列表中可以嵌套列表,有序列表不必局限于序列,如下图所示:
- 爱你所爱
- 行你所行
- 听从你心
- 无问西东
代码
代码使用的符号为 Tab 键上方的键的英文输出符号
行代码
语法:`print(“Hello world!”)`
效果:print("Hello world!")
代码块
语法:
```
a = 1
b = 2
print(a+b)
```
效果:
a = 1
b = 2
print(a+b)
代码高亮
**Markdown支持代码高亮,只需在代码块的第一个符号后加上相应的语言名称即可
语法:
```py
a = 1
b = 2
print(a+b)
```
或者
```python
a = 1
b = 2
print(a+b)
```
效果:
a = 1
b = 2
print(a+b)
a = 1
b = 2
print(a+b)
超链接
自动链接
使用 <> 包括的URL或邮箱地址会被自动转化为超链接
本地链接
语法:[Link text](…/Google.html)
效果:Google
提醒:.在路径中表示返回上一级,.的数量代表着返回的级数
网络链接
语法:[Link text](URL)
效果:CSDN
图片
本地链接
同超链接的本地链接差不多,只不过在语句最前面加上一个治感冒的感叹号
语法格式:![图片命名](相对路径)
网络链接
同超链接的网络链接差不多,只不过在语句最前面加上一个感叹号
语法:![图片命名](URL)
效果:
表格
单元格和表头
- 使用 | 来分隔不同的单元格,用 - 分割表头和其他行
- 为了美观,一般在左右两侧都是用 | 来标记单元格边界
- 为了看起来更为清晰,| 和 - 两侧需要至少有一个空格
对齐
- :— 代表左对齐
- :–: 代表居中对齐
- —:代表右对齐
更多
表格的更多操作可使用 HTML 的表格操作方法
引用
单行引用
语法:
>这里是引用
效果:
这里是引用
多行引用
可在每行前都加上引用符号>
嵌套引用
一层引用中可以嵌套下一层引用
语法:
>一层引用
>>二层引用
>>>三层引用
效果:
一层引用
二层引用
三层引用
数学符号及公式
- 绝大部分的 Markdown 编辑器都支持使用 Latex 语法进行数学符号及公式的编辑,通过 Mathjax 插件实现,基本上默认存在,无需手动安装。
- 因为使用 Latex 语法实现数学符号及公式的编辑,因此其使用同 Latex 的语法一致。同时,受限于环境,Markdown仅提供最基本的数学符号及公式的编辑,Latex的其他功能并没有包含于其中。
- 因为网上资源较多,所以我选择了一篇较为不错的入门介绍供大家参考:Markdown数学公式语法
- 关于 Latex 的更多符号可参考:
Latex常用特殊符号对应表
数学专题之希腊字符的插入
待办事项
语法:
* [ ] C
- [ ] C++
- [X] Java
* [x] Python
效果:
- C
- C++
- Java
-
Python
-
*和\均可
-
x可选,也可在生成页面自行带上对号
-
可向列表一样进行嵌套
Markdown格式转换
依照所使用的环境不同,方法亦有所不同,这里以CSDN的博客系统为例
导入
导出
- 如果想转化为PDF格式,可以先保存为HTML格式,然后通过网页打印功能实现
- 如果想转化为WORD格式,可以先保存为HTML格式,复制粘贴即可
编辑器与扩展
这一方面可参考上述提到的参考源: Learning-Markdown