Hexo中Markdown语法(GFM)使用
提起Markdown,对我来说是毕设、是项目、是不可多得的助手。
Markdown 是一种轻量级的”标记语言”,优点在于
(1)可以更加专注文章内容而不是排版样式。
(2)轻松的导出 HTML 和本身的 .md 文件。
(3)纯文本内容,兼容所有的文本编辑器与字处理软件。
(4)可读,直观。适合所有人的写作语言。
查资料了解到,Hexo下使用的MarkDown为Github的 GFM ,风格很漂亮,简洁美观大方。但是GFM 的MarkDown语法和标准的MarkDown稍有不同,使用过程中需要注意一些,在下面的介绍中我会进行说明的请放心。
1 Markdown语法
1.1 标题
Markdown支持6种级别的标题,对应html标签 h1 ~ h6
1 | # h1 //一级标题 对应 <h1> </h1> |
1.2 段落及区块引用
Markdown提供了一个特殊符号 > 用于段首进行强调,被强调的文字部分将会高亮显示
1 | > 这段文字将会被高亮显示... |
以上标记显示效果如下:
1.3 插入链接或图片
Markdown针对链接和图片的处理也比较简单,可以使用下面的语法进行标记
1 | [点击跳转至百度](https://www.baidu.com) |
以上标记显示效果如下:
注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。
1.4 列表
Markdown支持有序列表和无序列表两种形式:
无序列表使用 * 或 + 或 - 标识
有序列表使用数字加 . 标识,例如:1.
1.5 分隔线
有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以
1 | *** |
以上标记显示效果如下:
*
1.6 内容强调
有时候,我们对某一部分文字进行强调,使用 * 或 _ 包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗
1 | *这里是斜体* |
以上标记显示效果如下:
这里是斜体
这里是斜体
这里是加粗
这里是加粗
这里是加粗并斜体
这里是加粗并斜体
1.7 删除线
1 | 这样来 ~~删除一段文本~~ |
以上标记显示效果如下:
这样来 删除一段文本
1.8 高亮显示
1 | 使用<code>\`</code>来强调字符//想打出 ` (反引号)需要转义,加<code></code>标签强调 |
以上标记显示效果如下:
使用`
来强调字符
比如 突出背景色
来显示强调效果
1.9 嵌套引用
1 | > 动物 |
以上标记显示效果如下:
动物
水生动物
陆生动物猴子
人程序猿
攻城狮
产品狗 //这里需要注意,没有空行间隔,忽略降级引用标记
射鸡虱 //这里需要注意,没有空行间隔,忽略降级引用标记两栖类动物
大鳄鱼
唐老鸭
两个回车结束引用,不在引用范围内了!
1.10 修改图片
1.10.1 设置图片尺寸
在 markdown 直接使用提供的语法引入图片是无法设置大小的,所以我们需要用到 html 的 img 标签。
1 | <img width=" " alt="描述" src="url"/> |
例如:
1 | <img width="267px" alt="欢迎来访呀朋友" src="https://wugenqiang.github.io/PictureBed/pictures/013.jpg"/> |
效果如下:
1.10.2 设置图片居中
在 markdown 设置图片居中是需要通过 div 来控制的。
1 | <div align=center><img width="267px" alt="欢迎来访呀朋友" src="https://wugenqiang.github.io/PictureBed/pictures/013.jpg"/></div> |
效果如下:
1.11 插入代码块
Markdown在IT圈子里面比较流行的一个重要原因是,它能够轻松漂亮地插入代码。
方法是,使用三个反引号 ` 进行包裹即可。如果是行内代码引用,使用单个反引号进行包裹
代码块语法遵循标准 markdown
代码,使用 ``` 开始 ,``` 结束 例如:
1 | ```Python |
以上标记显示效果如下:
1 | #!/usr/bin/env python |
注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键点击即可。
有人会问:
如何在代码块中打出 ```
实际上是使用 4个` 包含 3个` 就可以了,想表示更多,最外层+1就好了。
````
```
```
````
1.12 插入表格
表格是Markdown语法中比较复杂的一个,其语法如下:
1 | 列1 | 列2 | 列3 |
以上标记显示效果如下:
列1 | 列2 | 列3 |
---|---|---|
第1行 | 12 | 13 |
第2行 | 22 | 23 |
第3行 | 32 | 33 |
可以使用冒号
来定义对齐方式:
全居中样式:
1 | 表头|条目一|条目二 |
以上标记显示效果如下:
表头 | 条目一 | 条目二 |
---|---|---|
项目 | 项目一 | 项目二 |
可能有人喜欢左对齐或者右对齐,也可以设置:
1 | | 左对齐 | 右对齐 | 居中 | |
以上标记显示效果如下:
左对齐 | 右对齐 | 居中 |
---|---|---|
Computer | 5000 元 | 1台 |
Phone | 1999 元 | 1部 |
注:三个短竖杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。
1.13 特殊符号处理
Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:
1 | \ 反斜线 |
例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可:\ \ => \ 。
注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。
重要:MarkDown表格中使用竖线,如何做?
表格中使用竖线 竖线数目
| 一个竖线: & # 1 2 4 ;
|| 两个竖线: & # 1 2 4 ; & # 1 2 4 ;
1.14 文本居中引用
1 | {% cq %} |
以上标记显示效果如下:
人生乃是一面镜子,
从镜子里认识自己,
我要称之为头等大事,
也只是我们追求的目的!
注:如果想修改字号,可以如下面这样设置:
1 | <font size="4"> |
以上标记显示效果如下:人生乃是一面镜子, 从镜子里认识自己, 我要称之为头等大事, 也只是我们追求的目的!
1.15 主题自带样式 note 标签
1 | <div class="note default"><p>default</p></div> |
以上标记显示效果如下:
default
1 | <div class="note primary"><p>primary</p></div> |
以上标记显示效果如下:
primary
1 | <div class="note success"><p>success</p></div> |
以上标记显示效果如下:
success
1 | <div class="note warning"><p>warning</p></div> |
以上标记显示效果如下:
warning
1 | <div class="note danger"><p>danger</p></div> |
以上标记显示效果如下:
danger
在主题配置文件
中需要配置下:
1 | # Note tag (bs-callout). |
1.16 文字处理
1.16.1 文字背景色
1 | <table><tr><td bgcolor=#FFFF00>背景色的设置是按照十六进制颜色值:#FFFF00</td></tr></table> |
效果如下:
背景色的设置是按照十六进制颜色值:#FFFF00 |
背景色的设置是按照十六进制颜色值:#D1EEEE |
背景色的设置是按照十六进制颜色值:#C0FF3E |
背景色的设置是按照十六进制颜色值:#54FF9F |
1.16.2 文字字体
1 | <font face="黑体">我是黑体字</font> |
效果如下:
我是黑体字 我是宋体字 我是微软雅黑字1.16.3 文字大小
1 | size为1:<font size="1">size为1</font> |
效果如下:
size为1:size为1
size为2:size为2
size为3:size为3
size为4:size为4
size为10:size为10
1.16.4 文字颜色
1 | 红色文字:<font color="red">红色文字</font> |
效果如下:
红色文字:红色文字
浅红色文字:浅红色文字
蓝色文字:蓝色文字
浅蓝色文字:浅蓝色文字
绿色文字:绿色文字
金黄色文字:金黄色文字
浅黄色文字:浅黄色文字
深黄色文字:深黄色文字
需要其它更多的颜色,可以到下面这个网址查更多颜色的 RGB,或者直接用颜色的英文代替 RGB
RGB颜色查询对照表
1.16.4 同时改变字体,字号和颜色
1 | <font face="字体" size="字号" color="颜色">这里是需要突出显示的内容</font> |
效果如下:
这里是需要突出显示的内容 我是黑体字 我是微软雅黑 我是华文彩云 我是红色 我是绿色 我是蓝色 我是尺寸 我是黑体,绿色,尺寸为51.17 使用Emoji表情
使用前首先要开启 emoji
,默认是不显示的,参考:开启emoji表情
开启 emoji
后进行操作
举例:
1 | Hello Hexo NexT :smile: |
效果:
Hello Hexo NexT :smile:
更多可用 Emoji 代码参见 emoji-cheat-sheet 和 emojicopy
1.18 复选框列表(github可用,hexo不支持)
在列表符号后面加上 [x]
或者 [ ]
代表选中
或者未选中
情况
1 | - [ ] content |
- [x] C
- [x] C++
- [x] Java
- [x] Qt
- [x] Android
- [ ] C#
- [ ] .NET
1.19 脚注
使用 [^1]
[^1]:
的脚注对来表示
1 | Here is a footnote reference,[^1] and another.[^longnote] |
效果如下:
Here is a footnote reference,1 and another.longnote
1. Here is the footnote. ↩
longnote. Here’s one with multiple blocks. ↩
Subsequent paragraphs are indented to show that they
belong to the previous footnote.
2 文章编辑
2.1 文章配置
在hexo
文件夹下右键点击Git Bash here
后键入$hexo new page "name"
,source/_post
文件夹中就会生成name.md
文件,打开后即可编辑,编辑格式如下:
1 | --- |
2.2 文章折叠
在要显示的文字末尾添加如下代码实现文章在主页的折叠显示。
1 | <!-- more --> |