前言
一般首页会有个 README.md 说明文件,可以使用以下命令生成:
git add README.md
一、快捷键
功能 | 快捷键 |
---|---|
加粗 | Ctrl + B |
斜体 | Ctrl + I |
引用 | Ctrl + Q |
插入链接 | Ctrl + L |
插入代码 | Ctrl + K |
插入图片 | Ctrl + G |
提升标题 | Ctrl + H |
有序列表 | Ctrl + O |
无序列表 | Ctrl + U |
横线 | Ctrl + R |
撤销 | Ctrl + Z |
重做 | Ctrl + Y |
二、基本语法
2.1 字体斜体、粗体、删除线
*斜体* => 斜体、_斜体_ => _斜体_、**加粗** => 加粗、***倾斜加粗*** => 倾斜加粗、~~ 删除线~~ => 删除线
2.2 分级标题
写法1:
# 一级标题、## 二级标题、### 三级标题、#### 四级标题、##### 五级标题、###### 六级标题
写法2:
一级标题:在一级标题下一行加一个或多个“=”;二级标题:在二级标题下一行加一个或多个“-”
2.3 链接
(1)普通链接:将链接地址用 < > 包起来:
(2)插入图片链接: ![图片描述](图片url)(图片描述可省略)
(3)参考链接:[关键字](链接地址 “添加一个标题(可选)”)
注意:配合 Hexo 使用可能会遇到这种情况,本地编辑器上的图片 url 使用相对路径可以显示,但 hexo g + hexo s 打包后失效。
建议:暂时缘由不明,研究发现将 xxx.md 对应所有图片放在文件夹 xxx 中(取名一致),且处于同一层目录下即可。
2.4 分割线
在一行中用三个以上的星号(*)、减号(-)或底线(_)生成分隔线,行内不能有其他东西。也可以在星号或减号中间插入空格。
2.5 代码块
写法1:
缩进4个空格或一个制表符(Tab)
写法2:
(1)用英文的单反引号(在 Esc 键下方,和 ~ 同一个键)包裹代码,多行代码需要在代码块上一行和下一行使用三个单反引号包裹,同时可在第一行反引号后面,输入代码块所使用的语言,实现代码高亮。
(2)在代码块中, & 、 < 和 > 会被 Markdown 自动转成 HTML 实体,示例:
2.6 引用
(1)在被引用的文本前加 > 号和一个空格,只输入了一个 > 号会产生一个空白的引用:
(2)引用嵌套使用:
(3)引用内也可加其他 Markdown 语法,包括标题、列表、代码块等这里不一一演示。
2.7 列表
(1)无序列表:使用 *,+,- 符号表示无序列表,符号后面一腚要有个空格。
(2)有序列表:使用数字和一个英文点号表示有序列表,点号后面一腚要有个空格。
(3)二者同时使用:
(4)列表内也可加入其他 Markdown 语法,包括标题、引用、代码块等这里不一一演示。
注意:
- 加粗效果不能直接用于列表标题里面,但是可以嵌套在列表里面混合使用。
- 列表中包含代码块(前面加2个 Tab 或者8个空格,并且需要空一行,否则不显示)。
- 数字后接英文点,会无意中生成列表,如2020.12.04日期,有时会被误认为列表。解决:在每个点前面加上 \ 即可。
2.8 表格
(1)多的不说直接上图:
(2)指定对齐方式:英文冒号在英文减号左侧表示左对齐,右侧则右对齐,两边都有表示居中。
三、常用技巧
3.1 换行
(1)连续两个以上空格 + 回车
(2)使用 HTML 换行标签
3.2 缩进字符
不断行的空白格或半角的空格或全角的空格:
3.3 特殊符号
(1)对于 Markdown 中的语法符号,前面加反斜杠 \ 即可显示符号本身:
(2)其他特殊字符:
3.4 脚注
在需要添加脚注的文本后加上[^注脚名字],然后在文本的任意位置(一般在最后)添加对应脚注:
注意:
脚注自动被搬运到最后面,请到文章末尾查看,脚注后方的链接可以直接跳转回到加注位置。
3.5 表情速查表
详情参考:表情语法大全 ,花里胡哨的一大堆…
四、高阶用法
4.1 Latex 数学公式
(1)行内公式:使用两个”$”符号引用公式
(2)行间公式:使用两对“$$”符号引用公式
详情参考:Latex数学符号
4.2 流程图
不建议用 Markdown 做各种图,仅作了解:
4.3 Todo 列表
4.4 序号图
4.5 甘特图
五、Markdown 工具
太多了太多了,这里只推荐两个顶呱呱的:Typora 和 MarkdownPad,我用的 Typora 。
Typora 的设计理念很 cool,是真正的即时预览型编辑器,不同于左右两个窗口,追求极致的简洁,它将「写字」和「预览」合体了。可切换到“源代码模式”,Typora 可进行多种文档格式转换如 Word。流畅度、反应速度很快,适合辣些手速快的ds(大神)贵族。有需要的伙计可以在官网下载后按需破解白嫖 (⊙x⊙;)
MarkdownPad 被很多人称赞为 Windows 下最好用的 Markdown 编辑器之二,功能之强大自然不必解释: