玩命加载中 . . .

Markdown 使用详解(附图文)

前言

​ 一般首页会有个 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 语法,包括标题、引用、代码块等这里不一一演示。

注意:

  1. 加粗效果不能直接用于列表标题里面,但是可以嵌套在列表里面混合使用。
  2. 列表中包含代码块(前面加2个 Tab 或者8个空格,并且需要空一行,否则不显示)。
  3. 数字后接英文点,会无意中生成列表,如2020.12.04日期,有时会被误认为列表。解决:在每个点前面加上 \ 即可。

2.8 表格

(1)多的不说直接上图:

(2)指定对齐方式:英文冒号在英文减号左侧表示左对齐,右侧则右对齐,两边都有表示居中。

三、常用技巧

3.1 换行

(1)连续两个以上空格 + 回车
(2)使用 HTML 换行标签

3.2 缩进字符

不断行的空白格或半角的空格或全角的空格:

3.3 特殊符号

(1)对于 Markdown 中的语法符号,前面加反斜杠 \ 即可显示符号本身:

(2)其他特殊字符:

(3)字符对应的 Unicode

3.4 脚注

在需要添加脚注的文本后加上[^注脚名字],然后在文本的任意位置(一般在最后)添加对应脚注:

注意:
脚注自动被搬运到最后面,请到文章末尾查看,脚注后方的链接可以直接跳转回到加注位置。

3.5 表情速查表

详情参考:表情语法大全 ,花里胡哨的一大堆…

四、高阶用法

4.1 Latex 数学公式

(1)行内公式:使用两个”$”符号引用公式
(2)行间公式:使用两对“$$”符号引用公式
详情参考:Latex数学符号

4.2 流程图

不建议用 Markdown 做各种图,仅作了解:

4.3 Todo 列表

4.4 序号图

4.5 甘特图

五、Markdown 工具

太多了太多了,这里只推荐两个顶呱呱的:TyporaMarkdownPad,我用的 Typora

Typora 的设计理念很 cool,是真正的即时预览型编辑器,不同于左右两个窗口,追求极致的简洁,它将「写字」和「预览」合体了。可切换到“源代码模式”,Typora 可进行多种文档格式转换如 Word。流畅度、反应速度很快,适合辣些手速快ds(大神)贵族。有需要的伙计可以在官网下载后按需破解白嫖 (⊙x⊙;)

MarkdownPad 被很多人称赞为 Windows 下最好用的 Markdown 编辑器之二,功能之强大自然不必解释:


 上一篇
Bootstrap - table 使用总结 Bootstrap - table 使用总结
最近在帮忙迭代公司的一个快速开发平台项目,得将之前 Bootstrap 开发的部分用 Element 取代,里面还有 jQuery 的一些 zTree、UI Layout,若依等插件封装好的语法和 Element 冲突,这里整理记录一下。
2021-01-20
下一篇 
Hexo + GitHub 搭建教程 Hexo + GitHub 搭建教程
本文是一篇记录该小站在2020年12月4日呱呱坠地的初步搭建指南,希望能帮到想建站的小伙伴 ♪♪
2020-12-04
  目录