前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Hexo中Markdown语法(GFM)使用

Hexo中Markdown语法(GFM)使用

作者头像
零式的天空
发布2022-03-27 15:16:20
2.5K0
发布2022-03-27 15:16:20
举报
文章被收录于专栏:零域Blog零域Blog

提起Markdown,对我来说是毕设、是项目、是不可多得的助手。 Markdown 是一种轻量级的”标记语言”,优点在于 (1)可以更加专注文章内容而不是排版样式。 (2)轻松的导出 HTML 和本身的 .md 文件。 (3)纯文本内容,兼容所有的文本编辑器与字处理软件。 (4)可读,直观。适合所有人的写作语言。 查资料了解到,Hexo下使用的MarkDown为Github的 GFM ,风格很漂亮,简洁美观大方。但是GFM 的MarkDown语法和标准的MarkDown稍有不同,使用过程中需要注意一些,在下面的介绍中我会进行说明的请放心。

1 Markdown语法

1.1 标题

Markdown支持6种级别的标题,对应html标签 h1 ~ h6

代码语言:javascript
复制
# h1   //一级标题 对应 <h1> </h1>
## h2   //二级标题 对应 <h2> </h2>
### h3  //三级标题 对应 <h3> </h3>
#### h4  //四级标题 对应 <h4> </h4>
##### h5  //五级标题 对应 <h5> </h5>
###### h6  //六级标题 对应 <h6> </h6>

1.2 段落及区块引用

Markdown提供了一个特殊符号 > 用于段首进行强调,被强调的文字部分将会高亮显示

代码语言:javascript
复制
> 这段文字将会被高亮显示...

以上标记显示效果如下:

1.3 插入链接或图片

Markdown针对链接和图片的处理也比较简单,可以使用下面的语法进行标记

代码语言:javascript
复制
[点击跳转至百度](https://www.baidu.com)
![图片](https://wugenqiang.github.io/PictureBed/pictures/015.jpg)

以上标记显示效果如下:

点击跳转至百度

注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。

1.4 列表

Markdown支持有序列表和无序列表两种形式:

  • 无序列表使用 * 或 + 或 - 标识
  • 有序列表使用数字加 . 标识,例如:1.

1.5 分隔线

有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以

代码语言:javascript
复制
***
---

以上标记显示效果如下:

*

1.6 内容强调

有时候,我们对某一部分文字进行强调,使用 * 或 _ 包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗

代码语言:javascript
复制
*这里是斜体*
_这里是斜体_

**这里是加粗**
__这里是加粗__

***这里是加粗并斜体***
___这里是加粗并斜体___

以上标记显示效果如下:

这里是斜体 这里是斜体

这里是加粗 这里是加粗

这里是加粗并斜体 这里是加粗并斜体

1.7 删除线

代码语言:javascript
复制
这样来 ~~删除一段文本~~

以上标记显示效果如下:

这样来 删除一段文本

1.8 高亮显示

代码语言:javascript
复制
使用<code>\`</code>来强调字符//想打出 ` (反引号)需要转义,加<code></code>标签强调
比如`突出背景色`来显示强调效果

以上标记显示效果如下:

使用`来强调字符 比如 突出背景色 来显示强调效果

1.9 嵌套引用

代码语言:javascript
复制
> 动物
>> 水生动物
>> 陆生动物
>>> 猴子
>>> 人
>>>> 程序猿
>>>> 攻城狮
>>产品狗 //这里需要注意,没有空行间隔,忽略降级引用标记
射鸡虱   //这里需要注意,没有空行间隔,忽略降级引用标记

>> 两栖类动物
>>> 大鳄鱼
唐老鸭

两个回车结束引用,不在引用范围内了!

以上标记显示效果如下:

动物 水生动物 陆生动物 猴子 人 程序猿 攻城狮 产品狗 //这里需要注意,没有空行间隔,忽略降级引用标记 射鸡虱 //这里需要注意,没有空行间隔,忽略降级引用标记 两栖类动物 大鳄鱼 唐老鸭

两个回车结束引用,不在引用范围内了!

1.10 修改图片

1.10.1 设置图片尺寸

在 markdown 直接使用提供的语法引入图片是无法设置大小的,所以我们需要用到 html 的 img 标签。

代码语言:javascript
复制
<img width="  " alt="描述" src="url"/>

例如:

代码语言:javascript
复制
<img width="267px" alt="欢迎来访呀朋友" src="https://wugenqiang.github.io/PictureBed/pictures/013.jpg"/>

效果如下:

1.10.2 设置图片居中

在 markdown 设置图片居中是需要通过 div 来控制的。

代码语言:javascript
复制
<div align=center><img width="267px" alt="欢迎来访呀朋友" src="https://wugenqiang.github.io/PictureBed/pictures/013.jpg"/></div>

效果如下:

1.11 插入代码块

Markdown在IT圈子里面比较流行的一个重要原因是,它能够轻松漂亮地插入代码。 方法是,使用三个反引号 ` 进行包裹即可。如果是行内代码引用,使用单个反引号进行包裹

代码块语法遵循标准 markdown 代码,使用 ``` 开始 ,``` 结束 例如:

代码语言:javascript
复制
​```Python
#!/usr/bin/env python
# -*- coding: utf-8 -*-
print 'Hello World! 
```

以上标记显示效果如下:

代码语言:javascript
复制
#!/usr/bin/env python
# -*- coding: utf-8 -*-
print 'Hello World! 

注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键点击即可。 有人会问: 如何在代码块中打出 ``` 实际上是使用 4个` 包含 3个` 就可以了,想表示更多,最外层+1就好了。 ```` ``` ``` ````

1.12 插入表格

表格是Markdown语法中比较复杂的一个,其语法如下:

代码语言:javascript
复制
列1   | 列2 | 列3 
----- | --- | ---- 
第1行 | 12  | 13  
第2行 | 22  | 23  
第3行 | 32  | 33  

以上标记显示效果如下:

列1

列2

列3

第1行

12

13

第2行

22

23

第3行

32

33

可以使用冒号来定义对齐方式:

全居中样式:

代码语言:javascript
复制
表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二

以上标记显示效果如下:

表头

条目一

条目二

项目

项目一

项目二

可能有人喜欢左对齐或者右对齐,也可以设置:

代码语言:javascript
复制
| 左对齐    |  右对齐 | 居中 |
| :-------- | -------:| :--: |
| Computer  | 5000 元 |  1台 |
| Phone     | 1999 元 |  1部 |

以上标记显示效果如下:

左对齐

右对齐

居中

Computer

5000 元

1台

Phone

1999 元

1部

注:三个短竖杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。

1.13 特殊符号处理

Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:

代码语言:javascript
复制
\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可:\ \ => \ 。

注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

重要:MarkDown表格中使用竖线,如何做?

表格中使用竖线 竖线数目 | 一个竖线: & # 1 2 4 ; || 两个竖线: & # 1 2 4 ; & # 1 2 4 ;

1.14 文本居中引用

代码语言:javascript
复制
{% cq %}
人生乃是一面镜子,
从镜子里认识自己,
我要称之为头等大事,
也只是我们追求的目的!
{% endcq %}

以上标记显示效果如下:

人生乃是一面镜子, 从镜子里认识自己, 我要称之为头等大事, 也只是我们追求的目的!

注:如果想修改字号,可以如下面这样设置:

代码语言:javascript
复制
<font size="4">
{% cq %}
  人生乃是一面镜子,
  从镜子里认识自己,
  我要称之为头等大事,
  也只是我们追求的目的!
{% endcq %}
</font>

以上标记显示效果如下:

人生乃是一面镜子, 从镜子里认识自己, 我要称之为头等大事, 也只是我们追求的目的!

1.15 主题自带样式 note 标签

代码语言:javascript
复制
<div class="note default"><p>default</p></div>

以上标记显示效果如下:

default

代码语言:javascript
复制
<div class="note primary"><p>primary</p></div>

以上标记显示效果如下:

primary

代码语言:javascript
复制
<div class="note success"><p>success</p></div>

以上标记显示效果如下:

success

代码语言:javascript
复制
<div class="note warning"><p>warning</p></div>

以上标记显示效果如下:

warning

代码语言:javascript
复制
<div class="note danger"><p>danger</p></div>

以上标记显示效果如下:

danger

主题配置文件中需要配置下:

代码语言:javascript
复制
# Note tag (bs-callout).
note:
  # 风格
  style: flat
  # 要不要图标
  icons: true
  # 圆角矩形
  border_radius: 3
  light_bg_offset: 0

1.16 文字处理

1.16.1 文字背景色

代码语言:javascript
复制
<table><tr><td bgcolor=#FFFF00>背景色的设置是按照十六进制颜色值:#FFFF00</td></tr></table>
<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值:#D1EEEE</td></tr></table>
<table><tr><td bgcolor=#C0FF3E>背景色的设置是按照十六进制颜色值:#C0FF3E</td></tr></table>
<table><tr><td bgcolor=#54FF9F>背景色的设置是按照十六进制颜色值:#54FF9F</td></tr></table>

效果如下:

背景色的设置是按照十六进制颜色值:#FFFF00

背景色的设置是按照十六进制颜色值:#D1EEEE

背景色的设置是按照十六进制颜色值:#C0FF3E

背景色的设置是按照十六进制颜色值:#54FF9F

1.16.2 文字字体

代码语言:javascript
复制
<font face="黑体">我是黑体字</font>
<font face="宋体">我是宋体字</font>
<font face="微软雅黑">我是微软雅黑字</font>

效果如下:

我是黑体字我是宋体字我是微软雅黑字

1.16.3 文字大小

代码语言:javascript
复制
size为1:<font size="1">size为1</font>
size为2:<font size="2">size为2</font>
size为3:<font size="3">size为3</font>
size为4:<font size="4">size为4</font>
size为10:<font size="10">size为10</font>

效果如下:

size为1:size为1 size为2:size为2 size为3:size为3 size为4:size为4 size为10:size为10

1.16.4 文字颜色

代码语言:javascript
复制
红色文字:<font color="red">红色文字</font>
浅红色文字:<font color="#dd0000">浅红色文字</font> 
蓝色文字:<font color="blue">蓝色文字</font>
浅蓝色文字:<font color="#0000dd">浅蓝色文字</font>
绿色文字:<font color="green">绿色文字</font>
金黄色文字:<font color="#FFFF00">金黄色文字</font>
浅黄色文字:<font color="#dddd00">浅黄色文字</font> 
深黄色文字:<font color="#666600">深黄色文字</font>

效果如下:

红色文字:红色文字 浅红色文字:浅红色文字 蓝色文字:蓝色文字 浅蓝色文字:浅蓝色文字 绿色文字:绿色文字 金黄色文字:金黄色文字 浅黄色文字:浅黄色文字 深黄色文字:深黄色文字

需要其它更多的颜色,可以到下面这个网址查更多颜色的 RGB,或者直接用颜色的英文代替 RGB RGB颜色查询对照表

1.16.4 同时改变字体,字号和颜色

代码语言:javascript
复制
<font face="字体" size="字号" color="颜色">这里是需要突出显示的内容</font>
<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=red>我是红色</font>
<font color=#008000>我是绿色</font>
<font color=Blue>我是蓝色</font>
<font size=5>我是尺寸</font>
<font face="黑体" color=green size=5>我是黑体,绿色,尺寸为5</font>

效果如下:

这里是需要突出显示的内容我是黑体字我是微软雅黑我是华文彩云我是红色我是绿色我是蓝色我是尺寸我是黑体,绿色,尺寸为5

1.17 使用Emoji表情

使用前首先要开启 emoji,默认是不显示的 开启 emoji 后进行操作

举例:

代码语言:javascript
复制
Hello Hexo NexT :smile:

效果:

Hello Hexo NexT :smile:

更多可用 Emoji 代码参见 emoji-cheat-sheetemojicopy

1.18 复选框列表(github可用,hexo不支持)

在列表符号后面加上 [x] 或者 [ ] 代表选中或者未选中情况

代码语言:javascript
复制
- [ ] content 
-空格[空格]空格content 
解释: [ ]括号里面的空格可以换成[x],代表选中对话框
  • [x] C
  • [x] C++
  • [x] Java
  • [x] Qt
  • [x] Android
  • [ ] C#
  • [ ] .NET

1.19 脚注

使用 [^1] [^1]:的脚注对来表示

代码语言:javascript
复制
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.

效果如下:

Here is a footnote reference,1 and another.longnote

1. Here is the footnote.

longnote. Here’s one with multiple blocks.

代码语言:javascript
复制
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文件,打开后即可编辑,编辑格式如下:

代码语言:javascript
复制
---
title: 文章名
date: 2019-04-09 12:27:52     //发表日期
updated: 2019-04-09 13:27:52  //更新日期
categories: Markdown          //文章分类
tags: [tag1,tag2]             //文章标签,多标签时使用英文逗号隔开
photos:                       //如果使用Fancybox(文章头部展示图片),如此设置  
                              //注意冒号后面有空格
---

2.2 文章折叠

在要显示的文字末尾添加如下代码实现文章在主页的折叠显示。

代码语言:javascript
复制
<!-- more -->
本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2019-03-31,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1 Markdown语法
    • 1.1 标题
      • 1.2 段落及区块引用
        • 1.3 插入链接或图片
          • 1.4 列表
            • 1.5 分隔线
              • *
                • 1.6 内容强调
                  • 1.7 删除线
                    • 1.8 高亮显示
                      • 1.9 嵌套引用
                        • 1.10 修改图片
                          • 1.10.1 设置图片尺寸
                          • 1.10.2 设置图片居中
                        • 1.11 插入代码块
                          • 1.12 插入表格
                            • 1.13 特殊符号处理
                              • 1.14 文本居中引用
                                • 1.15 主题自带样式 note 标签
                                  • 1.16 文字处理
                                    • 1.16.1 文字背景色
                                    • 1.16.2 文字字体
                                    • 1.16.3 文字大小
                                    • 1.16.4 文字颜色
                                    • 1.16.4 同时改变字体,字号和颜色
                                  • 1.17 使用Emoji表情
                                    • 1.18 复选框列表(github可用,hexo不支持)
                                      • 1.19 脚注
                                      • 2 文章编辑
                                        • 2.1 文章配置
                                          • 2.2 文章折叠
                                          领券
                                          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档