0 新建博文

0.1 新建博文

1

hexo new "你的博文名称"

0.2 参考设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

---
title: {{ title }} #【必需】页面标题
date: #【必需】页面创建日期
updated: #【可选】页面更新日期
tags: #【可选】文章标签
categories: #【可选】文章分类
keywords: #【可选】文章关键字
description: #【可选】文章描述
top: # 1 置顶
top_img: #【可选】文章顶部图片
comments: #【可选】显示文章评论模块(默认 true)
cover:  #【可选】文章缩略图
toc: #【可选】显示文章 TOC
toc_number: #【可选】显示 toc_number
toc_style_simple: #【可选】显示 toc 简洁模式
copyright: #【可选】显示文章版权模块
copyright_author: #【可选】文章版权作者
copyright_author_href: #【可选】作者链接
copyright_url: #【可选】版权链接
copyright_info: #【可选】版权声明文字
mathjax: #【可选】显示 mathjax
katex: #【可选】显示 katex
aplayer: #【可选】加载 aplayer 的 js 和 css
highlight_shrink: #【可选】配置代码框是否展开
aside: #【可选】显示侧边栏 (默认 true)
swiper_index: 10 #【可选】首页轮播图配置
top_group_index: 10 #【可选】首页右侧卡片组配置
ai: #【可选】文章 ai 摘要
background: "#fff" #【可选】文章主色
---
<div class="video-container">[视频内嵌代码]</div>
<style>.video-container { position: relative; padding-top: 56.25%; } .video-container iframe { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }</style>

0.3 更新并上线

1
2
3
4
5

# 本地预览
hexo cl && hexo g && hexo s

# 推送更新上线
hexo g && hexo d

1 Markdown 语法介绍

Markdown 是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与 HTML 混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown 被大量使用，如Github、Wikipedia、简书等。

官方文档：Markdown

2 Markdown 基本语法

2.1 标题语法

1
2
3
4
5
6

# 一级标题          或者用HTML语法：<h1>Heading level 1</h1>
## 二级标题			或者用HTML语法：<h2>Heading level 2</h2>
### 三级标题        ...
#### 四级标题       ...
##### 五级标题      ...
###### 六级标题     ...

• 需要主要的是，在#的后面要加上一个空格。

2.2 字体语法

2.2.1 设计粗体、斜体和删除线、高亮

2.2.1.1 语法

1
2
3
4
5
6

*这里是文字*            斜体
_这里是文字_            斜体
**这里是文字**          粗体
***这里是文字***        粗细体
~~这里是文字~~          删除线
==这里是文字==          高亮

2.2.1.2 渲染效果

这里是文字
这里是文字
这里是文字
这里是文字
这里是文字
这里是文字

2.2.2 设计字体、字号、颜色

这里，就需要用到HTML语法了。因为它本身是不支持修改字体、字号与颜色等功能的。
有些网站，比如像Github、知乎、简书等，它们就无法设置这种功能。不过像有的网站，比如像CSDN，它的Markdown编辑器做了很好的扩展、支持HTML语法，就有这样的功能。

2.2.2.1 语法

1

<font face='黑体' color=#ff0000 size=4>我是正文</font>

• 这里的黑体，也可以改成宋体、楷体、微软雅黑等等。

• 这里的size，是规定文本尺寸的大小。一般是从1-7，浏览器默认为3。

• 至于这里的color，建议可以用十六进制来表示，也可以用rgb来表示。

2.2.2.2 渲染效果

我是正文

2.2.2.3 RGB颜色值与十六进制颜色码对照表

RGB颜色值与十六进制颜色对照表

2.2.3 背景色

在markdown语法里，本身也是没有背景色这样一个选项的。所以，就需要用内置HTML的形式。

2.2.3.1 语法

1

<table><tr><td bgcolor=orange>背景色是：orange</td></tr></table>

2.2.3.2 渲染效果

2.3 链接语法

2.3.1 基本使用

2.3.1.1 语法

1

[文本替换链接](链接)

2.3.1.2 渲染效果

Penry 的秘密小屋

2.3.2 给链接加一个 title

什么叫给链接加标题？就是把你的鼠标放到该链接上时，会显示出来的文字。

2.3.2.1 语法

1

[文本替换链接](链接 "title")

2.3.2.2 渲染效果

Penry 的秘密小屋

2.3.3 图片链接

2.3.3.1 markdown语法

1

![图片解释性内容](图片链接)

2.3.3.2 渲染效果

2.3.3.3 HTML语法

1
2
3

<p align="center">
  <img src="" alt="alt text" width="70%" height="height">
</p>

• 这里设置图片居中，图片大小为原比例的 70% ，src 处填写图片地址或链接，alt text 填写描述性文本，在图片没有加载出来的时候会显示该文本。

2.3.3.4 渲染效果

2.3.3.5 把图片变成超链接

1

[![我的博客主页](...[相关图片链接])](跳转链接)

2.3.3.6 渲染效果

• 点击该图片可以跳转至博客主页

2.3.4 锚点

锚点实际上就是页内连接，可以方便页内跳转

2.3.4.1 语法

1
2
3

## 这是我的标题{#index}   //在某个标题后面设置锚点

跳转到[目录](#index)		//回到锚点

2.3.4.2 渲染效果

其它 Markdown 编辑器支持上述示例；
这里 hexo 使用锚点的时候，不需要在标题后面加上{#index}，而是在锚点处直接使用(#)会自动跳出对应锚点，如下图：

测试锚点2 Markdown基本语法

2.3.5 注脚

2.3.5.1 语法

1
2
3

xxxx[^1]xxxxx

[^1]:xxxxx

• 注：这里是英文的冒号，而不是中文的冒号；
• 注：脚注可能自动被搬运到最后面，请到文章末尾查看。

2.3.5.2 渲染效果

北京理工大学的前身是1940年诞生于延安的自然科学院，是中国共产党历史上第一个开展自然科学教学与研究的专门机构。毛泽东同志亲自题写校名，无产阶级革命家李富春，无产阶级革命家、教育家徐特立^[1]，无产阶级革命家、无线电专家、经济专家李强等先后担任学校主要领导。1949年，学校迁入北京；1952年，定名为北京工业学院，成为新中国第一所国防工业院校；1988年，更名为北京理工大学。她是中国共产党创办的第一所理工科大学，是新中国成立以来国家历批次重点建设的高校，首批进入国家“211工程”和“985工程”，首批进入“世界一流大学”建设高校A类行列，现隶属于工业和信息化部。

2.3.5.3 渲染效果图示

2.4 分割线语法

这个比较简单，如果要创建分隔线，在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容。

2.4.1 语法

1
2
3

***
---
___

2.4.2 渲染效果

2.5 代码语法

2.5.1 行内代码块

2.5.1.1 语法

1

`你的代码`

2.5.1.2 渲染效果

printf("hello world")

2.5.2 代码块

2.5.2.1 语法

1
2

``` language
code

1
2
3
4
5
6
7
8
9

- 注：这里的`language`选择语言类型，如`Python`、`cpp`等；
- 注：这里的`code`填写你的代码段。

#### 2.5.2.2 渲染效果

``` python
for i in range(1,11):
    print(i)

2.6 引用

2.6.1 语法

1

> 这是一个引用

2.6.2 渲染效果

这是一个引用

2.6.3 引用嵌套

1
2

> 这是一个引用
>> 这是一个引用嵌套

2.6.4 渲染效果

这是一个引用

这是一个引用嵌套

2.7 列表

2.7.1 无序列表

2.7.1.1 语法

1
2
3
4
5
6

- 我是无序列表
- 我是无序列表
+ 我是无序列表
+ 我是无序列表
* 我是无序列表
* 我是无序列表

2.7.1.2 渲染效果

• 我是无序列表
• 我是无序列表

• 我是无序列表
• 我是无序列表

• 我是无序列表
• 我是无序列表

2.7.2 有序列表

2.7.2.1 语法

1
2
3

1. 我是有序列表
2. 我是有序列表
3. 我是有序列表

2.7.2.2 渲染效果

1. 我是有序列表
2. 我是有序列表
3. 我是有序列表

2.8 表格

2.8.1 语法

1
2
3
4

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

2.8.2 渲染效果

3 Markdown其它常用语法

3.1 换行

• 连续两个以上空格+回车。

3.2 特殊符号

3.2.1 语法

1
2
3
4

\\          表示一个反斜线
\*          表示一个*
\{\}        表示一个{}
...（其他的类似，不再举例）

3.2.2 渲染效果

\ * {} `

3.3 其他特殊字符

这是用 Unicode码来进行转义的。想知道字符对应的Unicode码，请参考该网站，可能需要魔法：Unicode字符码

3.3.1 语法

1
2
3
4
5

✓   它是一个√

❄   它是一个❄

...

3.3.2 渲染效果

✓ 它是一个√

❄ 它是一个❄

4 高级用法

4.1 Latex数学公式

这里具体的公式可以用 AI 帮你转换成 Latex 格式再粘贴过来，也可以参考文档：Markdown常用数学符号和公式

4.1.1 行内公式

4.1.1.1 语法

1
2
3

$你的数学公式Latex格式$

$\frac{1}{2}$

4.1.1.2 渲染效果

$\frac{1}{2}$

4.1.2 行间公式

4.1.2.1 语法

1

$$你的数学公式Latex格式$$

4.1.2.2 渲染效果

$\sqrt{(\frac{1}{2})^2}$