结论： 本文是一份面向实际操作的 Linux 命令速查表，命令按任务场景组织。
内容状态： 示例来自早期学习环境；涉及系统服务、权限和网络的命令应先在测试环境验证。

Linux 基本命令与测试

本文当前覆盖文件与目录的基础操作。防火墙、NFS 和网络排错将在独立文章中整理，未发布前不保留失效入口。

创建文件夹

mkdir

1
2

ARDUINO
mkdir farmsec

建多个文件夹

1
2

CSS
mkdir A文件夹 B文件夹

建立文件路径

1
2

AWK
mkdir -p farmsec/farm/sec

创建隐藏目录

1
2

BASH
mkdir .study/xxxx

查看文件的一些信息

列出当前路径下文件名称

1
2

BASH
ls

列出其他目录下文件名称

1
2

AWK
ls farmsec/farm/sec

显示所有文件，包括隐藏文件

1
2

BASH
ls -a

隐藏文件：以“.”开头的文件名就是隐藏文件

显示文件权限、拥有者、创建日期 l:list

1
2

BASH
ls -l

以容易理解的方式列出文件大小

1
2

VIM
ls -lh

目录的查看及切换

显示当前路径的绝对路径

1
2

BASH
pwd

切换目录

1
2

BASH
cd xxxx/

回到家目录

1
2

BASH
cd  ~

返回上一级

1
2

GAMS
cd ..

返回刚才的目录

1
2

BASH
cd -

进入根目录

1
2

BASH
cd /

绝对路径：从根目录开始到目前路径

相对路径：不从根目录开始

ps：./执行可执行文件，不加./就会去/bin目录找这个命令，加了之后就会在当前路径下找

文件的创建及移动

创建新文件

1
2

BASH
touch farmsec

复制文件或目录cp

复制passwd到当前目录及opt/

1
2
3
4

AWK
cp /etc/passwd .

cp /etc/passwd /opt/

复制目录到其他目录

1
2

AWK
cp -r /farmsec/farm/sec srx/

连带修改时间和访问权限一同复制

1
2

AVRASM
cp -p

mv 剪切

将文件移走

1
2

AWK
mv /root/fsec/ .

重命名

1
2

BASH
mv fsec fsec1

直接覆盖旧的同名文件

1
2

POWERSHELL
mv -f fsec fsec

不覆盖任何文件

1
2

BASH
mv -n fsec fsec

rm 删除

删除前逐一询问

1
2

BASH
rm -i

即使文件属性为只读也删除，无需一一确认

1
2

POWERSHELL
rm -f

连带目录及下级目录都删除

1
2

BASH
rm -r

ps:

1.短选项可以拼接，长选项不可以拼接

2.Linux命令严格区分大小写，win不严格区分大小写

3.man 使用时可作命令说明使用

4.tab键的作用

5.输入前面字母后敲两下tab键：列出所有带此关键字的命令

6.输入路径关键字敲tab键：联想后面的路径名称

文件的编辑与查看

cat命令

打开文件查看内容，文件尾展示在最后

1
2

BASH
cat filename

代码高亮

1
2

BASH
cat -v filename

echo 输出命令

输出1111

1
2

APACHE
echo 1111

重定向符：> >> < <<

输出至文件，清除原文件内容

1
2

BASH
echo xxx > a.txt

追加至文件，不清除原文件内容

1
2

STYLUS
echo aaax >> a.txt

more 分屏查看文件

1
2

DOS
more filename

敲回车会一点点向下阅读，大文本阅读可用

less 查看文本

1
2

AWK
less /etc/passwd

ps：

输入q推出less

head 显示文件前10行

显示文件前3行

1
2

BASH
head -n 3 /etc/passwd|nl

tail 显示文件末尾10行

显示文件尾10行

1
2

AWK
tail /etc/passwd

显示文件尾3行

1
2

AWK
tail -n 3 /etc/passwd

取文件20-25行

1
2

BASH
cat /etc/passwd|nl|head -n 25|tail -n 6

滚动提取日志

1
2

BASH
tail -f *.log

| 管道符

获取前面执行命令的结果

wc 统计文件

统计行数

1
2

1C
ll | wc -l

查询封禁多少IP

1
2

AWK
wc -l /etc/passwd

统计字节数

1
2

BASH
wc -c

统计字符数

1
2

BASH
wc -m

统计单词数

wc -w

其他一些命令

1
2
3
4

BASH
du -h #查看当前路径下文件大小
df -h #查看磁盘使用情况
diff #比较两个文件内容是否一致

Linux文件结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

BASH

/bin：用户命令目录

/boot：系统启动需要用到的所有文件

/dev：tty 终端 usb U盘 cdrom 光驱

/etc：系统配置文件

/root：root用户目录

/lib：动态链接库

/media：光盘挂载点

/mnt：外部挂载点

/opt：安装的默认路径

/tmp：临时目录，充当垃圾站的角色，木马很容易上传到这个目录下

vi编辑器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

BASH

/xxx：搜索xxx

gg：回到第一行

数字+回车：光标向下跳几行

shift+g：最后一行

dd：删除一行

d2j：删除当前行和下两行

yy：复制一行

y2y：复制两行

p：粘贴到光标之后

P:粘贴到光标之后

好用的Linux命令在线查询手册

Linux命令大全（手册）

https://www.linuxcool.com/

结论： 本文适合需要复现 Ubuntu 20.04 虚拟机环境的读者，不应作为新项目的默认版本建议。
内容状态： 历史安装记录；下载地址、虚拟机版本和安全更新状态需要在执行前重新确认。

总的来说，安装 Ubuntu 包含以下三个步骤：

一、安装虚拟机

二、Ubuntu镜像下载

三、虚拟机配置

一、安装虚拟机

选择安装VMware Workstation，登录其官网下载安装包，链接如下：

下载 VMware Workstation Prowww.vmware.com/cn/products/workstation-pro/workstation-pro-evaluation.html

下载后运行安装向导，一直Next即可。最后的许可证可以在网上找到。

二、Ubuntu镜像下载

Linux 有多个发行版，本文选择桌面环境较为友好的 Ubuntu。进入 Ubuntu 镜像下载页面，选择 20.04 系列镜像：

Tsinghua Open Source Mirrormirrors.tuna.tsinghua.edu.cn/

三、虚拟机配置

step1：打开第一步所下载的VMware Workstation。在主界面中，选择【创建新的虚拟机】。

step2：如图，会自动弹出【新建虚拟向导】，选择【自定义（高级）】后，点击【下一步】。

step3：这一步选择默认值即可，点击【下一步】。

step4：选择【稍后安装操作系统】，点击【下一步】

step5：选择【Linux】，其下方版本将默认更改为【Ubuntu】。

step6：填写【虚拟机名称】及【位置】，点击【下一步】。【虚拟机名称】即虚拟机的名字。【位置】可以选择容量较大的硬盘位置。

step7：【处理器数量】与【每个处理器的内核数量】选择2后，点击【下一步】。

step8：选择【此虚拟机的内存】，此值应依据电脑本身情况酌情调整。常用值为1G（1024MB）、2G（2048MB）、4G（4096MB）等等。在这里选择4G。

step9：选择【使用网络地址转换】，点击【下一步】。

step10：选择推荐的【LSI Logic】即可，点击【下一步】。

step11：选择推荐的【SCSI】即可，点击【下一步】。

step12：选择【创建新虚拟磁盘】，点击【下一步】。

step13：设置【最大磁盘大小】为40，并选择【将虚拟磁盘拆分成多个文件】后，点击【下一步】。最大磁盘大小默认为20GB，磁盘剩余空间较大的话该数值可以往上加。

step14：点击【下一步】。

step15：点击【完成】。

step16：回到VMware Station界面，单机界面左侧【编辑虚拟机位置】。

step17-19：点击左侧的CD/DVD选项卡，右侧点击【使用ISO映像文件】，找到第二步在你清镜像中下载的Ubuntu镜像即可，点击【下一步】。

step20：回到VMware Station界面，点击【开启此虚拟机】。

【注】：此时若出现【此主机支持Intel VT-x，但Intel VT-x处于禁用状态】的提示。请进入BIOS，将【Intel Virtual Technology】设为【Enabled】即可，具体方法可百度。

step21：此时可以看到虚拟机画面，点击右侧【Install Ubuntu】。

step22：此时我们使用美国键盘布局【English（US）】，点击【Continue】。

step23：点击【Minimal installation】，点击【Continue】。由于Ubuntu虚拟机大多做学习研发使用，所以选择最小化安装。若是有用Ubuntu网上冲浪和打游戏的需求，请选择【Normal installation】。

step24：选择【Erase disk and install Ubuntu】，点击【Install Now】。

step25：点击【Continue】确认。

step26：点击地图上【中国】的位置，会默认出现Shanghai，点击【Continue】。

step27：输入【Your name】【Your computer’s name】【Pick a username】【Choose a password】【Confirm your password】后，点击【Continue】。这里建议密码设置的简单一些，因为Ubuntu后续很多操作需要验证密码，设置复杂的密码后期会比较麻烦。

等待安装。

点击【Restart Now】重新启动。

重新启动后，可以看到Ubuntu已经安装完成，点击出现的【用户名】。

输入密码即可以进入Ubuntu啦！

结论： 当前博客优先采用腾讯 COS + PicGo；其他服务保留为方案对比，不建议同时维护多套上传链路。
安全要求： 文中的 AccessKey、SecretKey 和 Token 只能使用占位符，真实密钥不得写入文章、截图或 Git 历史。

一、图床

1、图床是什么

中文名: 图床

功能: 专门储存图片的空间

国内图床: 单线空间，多线空间，cdn加速

图床种类: 国内和国外，有空间距离的因素

外文名: Image Hosting Service

类型： 云存储、PaaS、自建型、社交型

2、为什么要搭建图床

(不能把图片直接放在服务器里面吗)

由于服务器的空间有限，而cos提供的图片存储空间大，可以存储更多的图片，而且cos可以提供更快速、稳定的服务，这样可以更好地满足用户的需求。

cos概念指的是存储对象服务，是针对对象存储的抽象层，能提供安全的、可扩展的、高可用的对象存储服务，可以支持海量的数据存储。

服务器是一台提供网络服务的计算机，可以承载网站、应用程序等服务，也可以为客户端提供数据访问、文件服务等功能。

二. 选择合适的图床服务

1. 云存储型图床：像七牛云、阿里云OSS、腾讯云等都是云存储型图床，可以将图片直接上传至云端，可靠性高，容量大，易于管理。
2. PaaS型图床：如imgur、sm.ms、postimages等，这些图床大多是免费的，但容量有限，有些可能会限制上传速度和图片大小，适合个人或小型网站使用。
3. 自建型图床：自建型图床需要自己购买服务器、域名等，相对来说比较麻烦，但是可以满足自己的个性化需求，而且不受限于容量和速度等问题。
4. 社交型图床：如微博、QQ空间、豆瓣等，这些社交平台都提供了图片上传功能，可以将图片分享给好友或发布到社交平台上。

三. 注册账号并获取API密钥

1 、配置：服务器设置(1.阿里云;2.腾讯云;3.smms;4.其他)

1. 配置阿里云

阿里云安全稳定，是国内首屈一指的云服务供应商。阿里云配置较复杂，如果不喜欢复杂操作，可直接跳过阿里云配置这部分，smms配置最为简单且免费，其中，阿里云、腾讯云服务器需收费，阿里云40G存储空间半年仅需4.98元，外网下载\读取流量0.12 元/GB/月，腾讯也差不多也这个价，海星吧！

1.1. 注册阿里云账号

阿里云链接如下：

1

https://www.aliyun.com/

支付宝绑定注册即可，注册后完成实名认证，新人可获得一项云服务免费体验一个月。

1.2. 开通对象存储OSS服务并创建bucket

注册成功后，右上角点击进入 “控制台” ，在控制台左上角菜单栏选择 “对象存储OSS” ，并开通该服务。

点击左侧 “概览” ，再点击右侧 “创建bucket” ，如图：

按要求填写 “Bucket名称” ，“区域” 可任意选择，其他选项均可不改动，唯一需要改动的是 “读写权限” ，一定要改成 “公共读” ，复制保存一下 “Bucket名称” 和节点 “Endpoint” 信息，之后点击 “确定”。

1.3. 购买存储资源包

点击左上角菜单，进入 “资源包管理” ，点击 ”购买资源包“ ，新人可免费领取一个月的100G标准存储包，此外半年的40G存储包也仅需4.98元！

1.4. AccessKey 管理

点击右上角头像，进入 ”AcessKey管理“ ，安全起见，点击 ”开始使用子用户AcessKey“ ：

创建子用户账户登录和显示名称(随便取即可)，最后勾选 ”编程访问“ ，点击 "确认" 。

创建完用户后出现用户信息页面，该页面关闭后将无法再次获取相关信息，一定要保存好 “AcessKey ID” 和 ”AcessKey Secret“ ，在配置文件中会用到，可以下载CSV文件保存信息。

保存好相关信息后，点击 ”添加权限“ ，为该子用户添加访问权限，在搜索栏输入 ”oss" ，搜索所有关于 “对象存储oss” 的权限，一共两个，全部选中即可，右侧可看到当前已选择权限。

1.5. 创建配置文件模板

复制以下配置代码到记事本备用，其中 “xxxx” 需要替换，每个人均不一样，其他可不改动。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "picBed": {
        "uploader": "aliyun",
        "aliyun": {
        "accessKeyId": "xxxx",
        "accessKeySecret": "xxxx",
        "bucket": "xxxx",
        "area": "xxxx",
        "path": "img/",
        "customUrl": "xxxx",
        "options": ""
      }
    },
    "picgoPlugins": {}
  }

其中，“acesskeyId" 和 “acesskeySecret” 即为 “1.4. AcessKey管理” 中保存的用户信息；

其中， ”bucket“ 和 “area” 即为 ”1.2. 创建bucket“ 中保存的 ”Bucket名称“ 和节点 ”Endpoint" 信息，节点信息只需要取到前面的区域信息，后面的 “.http://aliyuncs.com” 删掉，以此处为例，“area” 对应为 “oss-cn-chengdu" 。

最后， “customUrl” 为外网访问链接，格式为：“http://" + “Bucket名称” + ”Endpoint“ ，此处最终的 ”customUrl“ 为:

1

http://typroa-test.oss-cn-chengdu.aliyuncs.com

“customUrl” 也可以从 “Bucket列表” 中直接获得，只需点击已创建的bucket将其展开就能获得外网访问链接。

1.6. Typora配置文件

将之前记事本中的配置信息填好，就准备好了 ”Typora“ 中 ”PicGo-Core" 的配置文件，这里给出一份配置文件参考，密钥内容隐去一部分。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "picBed": {
        "uploader": "aliyun",
        "aliyun": {
            "accessKeyId": "LTAI4GJx2DGB1xxxxxxxx",
            "accessKeySecret": "Ep6ynvPCG6bhEQPrCBksxxxxxxx",
            "bucket": "typroa-test",
            "area": "oss-cn-chengdu",
            "path": "img/",
            "customUrl": "http://typroa-test.oss-cn-chengdu.aliyuncs.com",
            "options": ""
        }
    },
    "picgoPlugins": {}
  }

打开 “Typora" 依次打开 ”文件 ----> 偏好 ----> 图像“ ，点击 ”打开配置文件“ ，将上面的配置代码完整复制到配置文件中，”Ctrl+S" 保存后关闭配置文件。

1.7. 大功告成！

最后，在 “打开配置文件”左侧 有个 “上传服务” ，点击 “验证图片上传选项” ，提示 “验证成功” ，则大功告成！

2. 配置腾讯云

腾讯云配置与阿里云大同小异，基本流程都差不多。

2.1. 注册腾讯云账号

腾讯云链接如下：

1

https://cloud.tencent.com/

用微信或QQ均可登录，注册后首先完成实名认证。

2.2. 开通对象存储COS并创建存储桶

点击 “云产品” ，在下拉菜单中找到 “对象存储” ，点击后开通该服务；

然后 “创建存储桶” ，其中 “访问权限” 一定要选择 “公有读私有写” ，“存储桶标签” 随便添几个就行；

2.3. 购买对象存储(COS)资源包

新手免费赠送了6个月50G标准存储容量，此外格外购买6个月10G标准存储包也只要4.96元。

2.4. 密钥管理

进入 “控制台” — “访问管理” ，然后点击 “API密钥管理” — “切换使用子账号密钥” 。

点击 “快速创建” ，快速创建子账号，创建完毕后，点击进入左侧 “用户列表”，点击创建好的子账户用户名，进入用户详情页。

在用户详情页中找到 “API密钥” 选项卡，点击 “新建密钥” ，几秒钟后生成密钥 “Secretid" 和 “SecretKey” ，复制保存以备用。

2.5. 配置文件

腾讯云的配置文件如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "picBed": {
    "uploader": "tcyun",
    "tcyun": {
      "secretId": "AKIDCBvVor9u85lFZcwuYx5xxxxxxxxxx",
      "secretKey": "RenmX1IJ3YoGTRAlzwc3eyxxxxxxxxxx",
      "bucket": "typora-1302184631",
      "appId": "1302184631",
      "area": "ap-chengdu",
      "path": "img/",
      "customUrl": "https://typora-1302184631.cos.ap-chengdu.myqcloud.com",
      "version": "v5"
    }
  },
  "picgoPlugins": {}
}

其中 “secretId” 和 “secretKey” 即为 ”2.4. 密钥管理“ 中获得的密钥。

剩余信息在 ”云产品“ — ”对象存储“ — ”存储桶列表“ 中，

点击存储桶名，选择 ”基础配置“ 选项卡，右侧 ”基本信息“ 中包含配置文件中剩余所需信息。

配置文件中，”bucket“ 对应 ”空间名称“ ；“appId” 对应 ”空间名称“ 后面的数字；”area“ 对应 ”所属地域“ 后面括号中的英文；”customUrl" 对应 “访问域名”。

2.6. 大功告成

打开 Typora 设置文件，将上面的配置文件代码完整复制进去，保存后关闭配置文件，最后

点击 “验证图片上传选项” ，提示验证成功，则大功告成！

3. 配置smms

“smms" 简单实用，可快速上手，而且免费，由于服务器在国外，不一定稳定。

3.1. 注册smms账号

smms账号注册链接如下：

1

https://sm.ms/home/apitoken

3.2. 生成 Secret Token

注册完成后，再次复制该链接打开如下界面：

点击 “Generate Secret Token" 生成 ”Secret Token" ，复制以备用。

3.3. 配置文件

打开 “Typora” 配置文件，将以下方代码复制到配置文件，其中 ”token" 即为上面图片中的 “Secret Token” ，保存配置文件。

1
2
3
4
5
6
7
8
9

{
  "picBed": {
    "uploader": "smms",
    "smms": {
      "token": "Fg8H9wYgYOdoOVmT94YlamD5hosy3nYX"
    }
  },
  "picgoPlugins": {}
}

3.4. 大功告成

最后 ，点击 “验证图片上传选项” ，提示 “验证成功” ，则大功告成！

4. 其他云服务器配置

其他云服务配置与前面三种云服务配置基本一致，故不再仔细列出，仅将各云服务与其对应配置文件给出如下：（双斜杠和后面的文字最后需删掉）

详细设置见见PicGo官方指南：https://picgo.github.io/PicGo-Doc/

4.1. 七牛图床

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "picBed": {
    "uploader": "qiniu",
    "qiniu": {
      "accessKey": "",
      "secretKey": "",
      "bucket": "", // 存储空间名
      "url": "", // 自定义域名
      "area": "z0" | "z1" | "z2" | "na0" | "as0", // 存储区域编号
      "options": "", // 网址后缀，比如?imgslim
      "path": "" // 自定义存储路径，比如img/
    }
  },
  "picgoPlugins": {}
}

4.2. 又拍云

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "picBed": {
    "uploader": "upyun",
    "upyun": {
      "bucket": "", // 存储空间名，及你的服务名
      "operator": "", // 操作员
      "password": "", // 密码
      "options": "", // 针对图片的一些后缀处理参数
      "path": "", // 自定义存储路径，比如img/
      "url": "" // 加速域名，注意要加http://或者https://
    }
  },
  "picgoPlugins": {}
}

4.3. GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "picBed": {
    "uploader": "github",
    "github": {
        "repo": "", // 仓库名，格式是username/reponame
        "token": "", // github token
        "path": "", // 自定义存储路径，比如img/
        "customUrl": "", // 自定义域名，注意要加http://或者https://
        "branch": "" // 分支名，默认是master
    }
  },
  "picgoPlugins": {}
}

4.4. Imgur

1
2
3
4
5
6
7
8
9
10

{
  "picBed": {
    "uploader": "imgur",
    "imgur": {
        "clientId": "", // imgur的clientId
        "proxy": "" // 代理地址，仅支持http代理
    }
  },
  "picgoPlugins": {}
}

四.选择一个合适的上传工具

可以通过工具将本地的图片上传到图床服务上。常用的上传工具有PicGo、uPic、Typora等等，不同的上传工具具有不同的特点和功能，可以根据自己的需求选择一个适合自己的上传工具。

五. 将上传工具配置好

将上传工具配置好，需要填写图床服务商提供的API密钥、上传地址、图片保存路径等信息。不同的上传工具配置方式可能不同，可以参考工具提供的文档进行操作。

六. 开始使用

配置好上传工具后，就可以开始使用了。将本地的图片拖拽到上传工具中，上传成功后会返回图片URL，将URL复制到需要插入图片的位置即可。

结论： Typora 最有价值的不是语法本身，而是自动保存、相对路径图片和导出组成的稳定写作流程。
适用范围： 本文界面和路径示例来自 2023 年 Windows 环境，具体菜单可能随版本变化。

Typora

一、配置

1.自动保存&调试模式（文章右键有检查元素：可以起到搜索检索作用)

2、自动复制图片到笔记文件夹(不然图片将是以电脑的绝对路径，分享给别人之后笔记之后打开不了)

文章保存目录示例：Typora/resources/Docs

文章图片目录示例：typora笔记.assets

3、主题安装与修改配置

主题安装

Typora 官方中文站

Typora主题官网

修改css样式(主题配置文件夹)

打开主题文件夹

4、Markdown配置修改

1.配置有关需要的扩展语法（上下标在写数学笔记的时候会比较常用）

二、Markdown 写作边界

Typora 是编辑器，不需要在本文重复维护完整的 Markdown 语法。标题、列表、代码块、链接、图片和表格等通用写法统一查询《Markdown 与 Butterfly 写作速查手册》。

本文只保留与 Typora 直接相关的内容：编辑器配置、图片路径、公式预览、HTML 扩展和导出流程。

三、Typora与数学公式

在本章中，重点不在于介绍如何插入数学公式，而在于如何表示数学符号。

3.1 如何插入数学公式

在Typora中，有两种方法插入数学公式，语法为：

1
2
3
4
5
6

第一种方法：$数学公式$
第二种方法：
$$
数学公式
$$
12345

第一种方法表示插入行内公式（内联公式），即可以将公式插入到一行中，比如1 + 2 = 3 1+2=31+2=3这样的公式。

第二种方法表示插入行间公式（外联公式），即可以将公式插入到行与行之间，单独占据一行或者数行的空间，并且居中放置。
1 + 2 = 3 1+2=31+2=3
如果要在行间公式内换行，在换行的位置使用\\。

接下来重点介绍如何表示数学符号。

3.2 上标下标

上下标可以使用^，_后跟相应的符号来实现。如：

上 标 ： a 1 ， 下 标 ： a 1 上标：a^1，下标：a_1上标：a1，下标：a1

如果作为上标、下标的符号不止一个，则需要用花括号{}将其括起来。如：

上 标 为 12 ： a 12 , 下 标 为 34 ： a 34 上标为12：a^{12},下标为34：a_{34}上标为12：a12,下标为34：a34

更多例子：
f ( x ) = x x x e x 2 e x 2 f(x)=x^{xx}\ e^{x2}\ e^{x2}\f(x)=xxxex2ex2

3.3 根号

我们可以使用\sqrt{}来表示根号。如：

1
2

\sqrt{2},\sqrt{5}
1

结果为：

2 , 5 \sqrt{2},\sqrt{5}2,5

我们也可以使用\sqrt[]{}来表示更具体的根号信息：

1
2

\sqrt[3]{4}，\sqrt[4]{10}
1

4 3 ， 10 4 \sqrt[3]{4}，\sqrt[4]{10}34，410

3.4 上下水平线

我们可以使用\underline{},\overline{}来表示上下水平线，如：

1
2
3

$下水平线：\underline{a+b}$
$上水平线：\overline{a+b}$
12

结果为：

下 水 平 线 ： a + b ‾ 下水平线：\underline{a+b}下水平线：a+b

上 水 平 线 ： a + b ‾ 上水平线：\overline{a+b}上水平线：a+b

3.5 上下水平大括号

我们可以使用\overbrace{} 和 \underbrace{} 在表达式的上、下方给出一水平的大括号

1
2
3

$\overbrace{x_1+x_2+x_3}$
$\underbrace{x_1+x_2+x_3}$
12

结果为：

x 1 + x 2 + x 3 ⏞ \overbrace{x_1+x_2+x_3}x1+x2+x3
x 1 + x 2 + x 3 ⏟ \underbrace{x_1+x_2+x_3}x1​+x2​+x3​​

当然，我们也可以在括号上添加说明，使用语法为\overbrace{}^{}和\underbrace{}_{}

1
2
3

$\overbrace{x_1+x_2+x_3}^{3个元素}$
$\underbrace{x_1+x_2+x_3}_{3个元素}$
12

x 1 + x 2 + x 3 ⏞ 3 个 元 素 \overbrace{x_1+x_2+x_3}^{3个元素}x1+x2+x33个元素

x 1 + x 2 + x 3 ⏟ 3 个 元 素 \underbrace{x_1+x_2+x_3}_{3个元素}3个元素x1+x2+x3

3.6 向量符号

我们可以使用\vec{}来表示单个字母向量，其实也可以表示多个字母，但不美观，另两个命令\overrightarrow{} 和\overleftarrow{}在定义从A 到B 的向量时非常有用。如：

1
2
3
4
5
6

$\vec{a}$
$\vec{AB}$
$\vec{ABC}$
$\overrightarrow{AB}$
$\overleftarrow{AB}$
12345

结果为：

a ⃗ \vec{a}a
A B ⃗ \vec{AB}AB

A B C ⃗ \vec{ABC}ABC

A B → \overrightarrow{AB}AB
A B ← \overleftarrow{AB}AB

3.7 分数

我们可以使用\frac{}{}来表示分数，如：

1
2
3

$\frac{1}{2}$
$\frac{\sqrt{3}}{4}$
12

结果为：

1 2 \frac{1}{2}21
3 4 \frac{\sqrt{3}}{4}43​​

3.8 积分运算符

积分运算符用\int 来生成 ，用\int_{}^{}来表示积分上下界，如：

1
2
3

$\int$
$\int_{1}^{2}$
12

结果为：

∫ \int∫
∫ 1 2 \int_{1}^{2}∫12​

3.9 求和运算符

求和运算符可以使用\sum来生成，用\sum_{}^{}来表示求和上下界，如：

1
2
3

$\sum$
$\sum_{i=1}^{10}x_i$
12

结果为：

∑ \sum∑
∑ i = 1 10 x i \sum_{i=1}^{10}x_i∑i=110​xi​

求和符号的上下标在内联公式里，表现为上面那样，当在外联公式里时，表现如下：
∑ i = 1 10 x i \sum_{i=1}^{10}x_ii=1∑10​xi​

3.10 连乘运算符

连乘运算符用\prod{}表示，同样地，上下标用prod_{}^{}表示，如：

1
2
3
4
5
6

$\prod$
$\prod_{i=1}^{10}x_i$
$$
\prod_{i=1}^{10}x_i
$$
12345

结果为：

∏ \prod∏
∏ i = 1 10 x i \prod_{i=1}^{10}x_i∏i=110​xi​
∏ i = 1 10 x i \prod_{i=1}^{10}x_ii=1∏10​xi​

3.11 特殊符号

希腊字母

α \alphaα为\alpha，β \betaβ为\beta，γ \gammaγ为\gamma，θ \thetaθ为\theta，ρ \rhoρ为\rho，λ \lambdaλ为\lambda，μ \muμ为\mu

Δ \DeltaΔ为\Delta，π \piπ为\pi，Ω \OmegaΩ为\Omega

关系运算符

大于>，大于等于≥ \geq≥为\geq或\ge

小于<，小于等于≤ \leq≤为\leq或\le

等于=，不等于≠ \neq\=为\neq或\ne

加减乘除

加+ 减-

乘× \times×为\times 除÷ \div÷为\div

3.12 矩阵表示

我们可以使用以下格式来显示矩阵：

1
2
3
4
5
6
7

$$
\begin{matrix}
1 & 2 & 3\\
4 & 5 & 6\\
\end{matrix}
$$
123456

结果为：
1 2 3 4 5 6

142536123456

142536
可是这并不是我们常见的矩阵啊，旁边的中括号呢？

别急，我们先把上面的公式说明一下：

• \begin{matrix}和\end{matrix}说明在它们之间的是矩阵
• 1 & 2 & 3\\表示第一行的元素，其中用&来分割每一个元素，用\\来换行

现在我们来加括号，很简单，语法如下：

1
2
3
4
5
6
7

$$
\left[\begin{matrix}
1 & 2 & 3\\
4 & 5 & 6
\end{matrix}\right]
$$
123456

结果为：
[ 1 2 3 4 5 6 ] \left[

142536123456

\right][142536]
其实我们仅仅在\begin{matrix}前面加了\left[，在\end{matrix}后面加了\right]，这样就能正确显示括号了，那我们可以将[]改为||吗，当然可以，就简单地把\left[，\right]改为\left|和\right|即可。

1
2
3
4
5
6
7

$$
\left|\begin{matrix}
1 & 2 & 3\\
4 & 5 & 6
\end{matrix}\right|
$$
123456

结果就能显示为行列式了。
∣ 1 2 3 4 5 6 ∣ \left|

142536123456

\right|∣∣∣∣142536∣∣∣∣
这里仅仅介绍简单的矩阵表示，如果要了解更多矩阵表示法，请自行搜索了解，网上的资料很多。

3.13 方程组

1
2
3
4
5
6
7
8
9
10
11
12

$$
\begin{equation}
\left\{
             \begin{array}{lr}
             x=\dfrac{3\pi}{2}(1+2t)\cos(\dfrac{3\pi}{2}(1+2t)), &  \\
             y=s, & 0\leq s\leq L,|t|\leq1.\\
             z=\dfrac{3\pi}{2}(1+2t)\sin(\dfrac{3\pi}{2}(1+2t)), &
             \end{array}
\right.
\end{equation}
$$
1234567891011

结果如下：(CSDN不支持）
KaTeX parse error: No such environment: equation at position 8: \begin{̲e̲q̲u̲a̲t̲i̲o̲n̲}̲ \left{ …

现在我们一一来解释：

• begin{equation}与\end{euqation}表示它们之间的为方程组。
• \left\{和\right.表示在方程组的左边加上{，在右边加上.，因为{在外联公式中有特殊的意义，因此需要在其前面加上转义字符\。
• \begin{array}和\end{array}表示它们之间的是数组，其实这也可以用来表示矩阵。
• {lr}表示有两列，第一列的值靠左排列，用l表示，第二列的值靠右排列，用r表示，如果是中间对齐则为c。
• 然后下面三行是方程式，用&分割，用\\换行。

3.14 分段函数

其实分段函数与方程组类似，示例如下：

1
2
3
4
5
6
7
8
9
10
11
12

$$
y=
\begin{equation}
\left\{
\begin{array}{lr}
x-1 & x \leq 0
x+1 & x>0
\end{array}
\right.
\end{equation}
$$
1234567891011

结果如下：（CSDN不支持）
KaTeX parse error: No such environment: equation at position 11: y= \begin{̲e̲q̲u̲a̲t̲i̲o̲n̲}̲ \left{ \be…
就是在\begin{equation}前加y=即可。

四、Typora与HTML

4.1 改变字体颜色及大小

我们可以使用<font> </font>标签来改变字体的颜色及大小，如：

1
2
3
4
5
6

<font size=3 color="red">字体颜色为红色，大小为3</font>

<font size=4 color="blue">字体颜色为蓝色，大小为4</font>

<font size=6 color="violet">字体颜色为紫罗兰，大小为6</font>
12345

结果为：

字体颜色为红色，大小为3

字体颜色为蓝色，大小为4

字体颜色为紫罗兰，大小为6

属性size表示字体大小，color表示颜色。

4.2 改变对齐方式

我们可以改变字体的对齐方式，用标签<p> </p>加上属性align，如：

1
2
3
4

<p align="left">左对齐</p>
<p align="center">中间对齐</p>
<p align="right">右对齐</p>
123

结果为：

左对齐

中间对齐

右对齐

4.3 插入图像

因为CSDN不支持使用img标签修改图像，所以下面的结果都不是准确的。大家可以自己在Typora中测试。
我们可以通过标签<img src=url />来插入图片，如：

1
2

<img src="img/1.jpg" />
1

结果为：

我们可以改变<img>标签的属性，来改变图片的大小。

1
2

<img src="img/1.jpg" width=100 height=100/>
1

将图片的宽高均设为100，结果为：

也可以改变图片的位置，如：

1
2
3

<img src="img/1.jpg" width=30 height=30 style="float:left"/>图片在左边
<img src="img/1.jpg" width=30 height=30 style="float:right"/>图片在右边
12

结果为：

图片在左边
图片在右边

五、扩展用法

5.1 插入emoji表情

我们可以使用:emoji:的语法来插入表情，比如：

:happy:的语法为:happy:

🦀的语法为:crab:

🐴的语法为:horse:

5.2 插入目录

当我们为使用标题将文分章节后，可以在输入[toc]命令的地方自动根据标题生成目录。

5.3 导出

选择文件 --> 导出，可以选择导出的文件格式，有pdf,html,word等格式。

5.4 文本高亮

在Typora中，可以用一对==将要高亮的文本括起来，如：

1
2
3

==要高亮的文本==
==背景会用黄色填充==
12

结果为：

要高亮的文本
背景会用黄色填充

这个功能可在偏好设置 --> Markdown扩展语法中设置。

5.5 上下标

在Typora中，可以用一对~将下标括起来，如：H~2~O表示H2O

同样，我们也可以用一对^将上标括起来，如：X^2^表示X2

上下标可在偏好设置 --> Markdown扩展语法中设置。

六、参考资料

[1] 菜鸟Markdown教程：https://www.runoob.com/markdown/md-tutorial.html

[2] 更多数学符号表达式：http://mohu.org/info/symbols/symbols.htm

[3] Latex 方程组表示： https://blog.csdn.net/lemolemac/article/details/9057471

[4] 菜鸟HTML教程：https://www.runoob.com/html/html-tutorial.html

结论： Butterfly 的高频改动应优先放在站点覆盖配置和 source 目录中，减少直接修改主题核心文件。
当前基线： Hexo 8.1.2、Butterfly 5.7.0；完整标签示例见《Markdown 与 Butterfly 写作速查手册》。

配置原则

本站的主题覆盖配置位于根目录 _config.butterfly.yml。菜单、搜索、侧栏、图片和评论等常规功能应优先在这里调整。

自定义样式和脚本分别放在主题的 source/css、source/js 中。修改主题模板前应先确认配置和 CSS 能否解决，避免后续升级产生大面积冲突。

文章置顶

在文章 Front Matter 中添加：

1

sticky: 2

数字越大，置顶优先级越高。只有真正承担入口作用的核心文章才需要置顶，历史教程不应长期占据首页顶部。

创建自定义页面

在 source 下建立页面目录，例如 source/example/index.md：

1
2
3
4
5

---
title: 示例页面
layout: page
comments: false
---

如果页面完全由独立 HTML、CSS 和 JavaScript 构成，可以使用：

1
2
3

---
layout: false
---

独立页面仍应检查移动端宽度、资源路径以及导航返回入口。

本地搜索

本站使用 Butterfly 5.7 的本地搜索配置：

1
2
3
4
5

search:
  use: local_search
  placeholder: 搜索文章
  local_search:
    preload: true

修改配置后执行 npx hexo generate，确认 public/search.xml 和搜索脚本正常生成。

插入原始 HTML

需要阻止 Markdown 渲染器处理局部 HTML 或模板代码时，可以使用 Raw 标签：

1
2
3

{% raw %}
<div class="example">HTML 内容</div>
{% endraw %}

不要在文章中直接嵌入来源不明的脚本。视频等第三方内容应使用 HTTPS，并补充标题与加载失败提示。

404 页面

主题配置中的 error_404.enable 控制 404 页面。修改后直接访问 /404.html 验证，不需要故意输入可能命中其他路由的地址。

发布前验证

1
2

npx hexo generate
npx hexo server

至少检查首页、文章页、自定义页面、搜索、移动端导航和浏览器控制台。日常热更新无需执行 hexo clean；只有删除页面后仍残留旧产物时才进行完整清理。

结论： 本文是区块链工程专题的原始索引，覆盖三个不同知识域，后续应拆成独立文章。
内容状态： 竞赛学习笔记，不代表生产级实现；密码学、交易签名和合约代码必须经过测试与审计。

UTXO

• outPutTxid要写Txid前缀

• 挖矿奖励inputTxid为nil，索引为-1.地址为nil

• input = output，如果转账后有余额，必须转账给自己

• 如果有多个input，要按从左往右的顺序写入

Solidity 合约

常用代码

关键字

• pragma solidity : 开头声明版本
• contract： 合约开头
• constructor: 声明构造函数，注意与contract区分，太长难以记住可以分为con-struct-or
• require: 用于确认条件是否满足，使用格式为：

  1 2 3 4 5

  function fun() public { require(条件语句,"字符串，可不写") } 示例： require(a == 1,"a不等于1")

• modifier: 函数修饰器,可以在函数执行前自动检查某个条件

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

  pragma solidity ^0.4.20; contract h { address owner ; int public a = 1; constructor () public { owner = msg.sender;///获取合约发起者的地址 } modifier Own{ require( owner == msg.sender,"");///判断当前函数调用者的地址是否等于owner _;//横杠一定要写，它表示了被修饰的函数的运行位置，这里在requir之后，若require失败则不运行 } function fun() Own public { a = 10; } }

状态变量

• msg.sender：solidity的状态变量，用于获取当前合约/函数的调用者地址，常用在构造函数中获取合约发起者的地址
• block.timestamp（）： 获取时间戳，类型为uint

合约部署

从构造函数constructor看

go技术代码

go version //查看版本

go env _w GO111MODULE=on / /开启环境变量

go env //查看库文件

go get -u golang.org/x/crypto/x/base58/… //拉取库文件

go.mod文件

运行代码和使用外部库需要使用go.mod文件，可以在vscode集成终端中输入命令创建:

1

go mod init [项目名]

时间戳

• 时间戳转换日期：
  使用unix函数

  1 2 3 4 5 6

  //1620221103转换 t := time.Unix(int64(1620221103), 0) fmt.Println(t) //2021-05-05 21:25:03 +0800 CST //CST表示中国时间，+0800表示时差，想要转换成世界协调UTC可以： //2021-05-05 13:25:03 +0000 UTC

• 计算时间差：
  使用sub函数

  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

  //时间戳 （1666194910） 与 时间戳 （1628202212）相差总秒/总分... t1 := time.Unix(int64(1666194910), 0) t2 := time.Unix(int64(1628202212), 0) dT := t1.Sub(t2) s := dT.Seconds() //算相差总秒数 fmt.Println(s) //37992698 m := dT.Minutes() //算相差总分钟 fmt.Println(m) //633211.6333333333 h := dT.Hours() //算相差总小时 fmt.Println(h) //10553.527222222223 d := dT.Hours() / 24 //算相差总天数 fmt.Println(d) //439.730300925926 取整数位 //算日期是那年的第几天 yearday := time.Unix(1666194910, 0).YearDay() fmt.Println(yearday) //292 //求相差()天()时()分()秒无敌求法 qijie := time.Unix(1666194910-1628202212, 0).UTC() fmt.Println(qijie) //妙算时分秒差，天数差用Day := dT.Hours()/24 //1971-03-16 17:31:38 +0000 UTC,day = 439.730300925926 //说明两天相差了439天，17小时,31分,38秒 //.UTC()转换为世界协调时，因为中国有时差，转换后时间差不对

加密算法

• md5：

  1 2 3 4 5 6 7 8 9 10

  //直接加密 data := []byte{1} //待加密数据,如果类型不是[]byte需要强转 hash := md5.Sum(data) //md5加密 fmt.Println(hash) //先new再write加密 md := md5.New() //new md.Write(data) //写入待加密数据 hash := md.Sum(nil) //在加密后的数据前拼接nil，即不拼接 fmt.Println(hash2)

• RIPEMD160:
  用法类似md5的第二种用法，使用前需导入“golang.org/x/crypto/ripemd160”

  1 2 3 4 5

  data := []byte{1} RIP := ripemd160.New() //新建 RIP.Write(data) //写入待加密数据 riped := RIP.Sum(nil) fmt.Print(riped)

• sha：
  sha有sha224，256等，用法类似

  1 2	data := []byte{1} sha256.Sum256(data)

编码

gob:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

//编码
data := "你好"                   //待编码数据
buf := new(bytes.Buffer)       //用来存储编码后的数据
encoder := gob.NewEncoder(buf) //新建编码器，参数为 加密后数据的存储位置
encoder.Encode([]byte(data))   //将data编码
fmt.Printf("%x\n", buf)
//090a0006e4bda0e5a5bd

//解码

deData := bytes.NewBuffer([]byte(data)) //用来存储解码后的数据
decoder := gob.NewDecoder(buf)          //新建解码器，参数为待解码数据
decoder.Decode(deData)                  //参数为解码后数据的存储位置
fmt.Printf("%s", deData)
//你好

base64:

base64可能会与rsa加密、签名一起出现，但题目可能未提及，需要自己记住去解码

1
2
3
4
5
6
7
8
9
10
11
12
13

//将[]byte数据编码为string
data := []byte{1, 2, 3}                               //待编码数据
stringData := base64.StdEncoding.EncodeToString(data) //参数为待编码数据，返回编码后的字符串
fmt.Println(stringData)
//AQID

//将字符串解码回[]byte
deData, err := base64.StdEncoding.DecodeString(stringData) //参数为待解码数据，返回解码后的数据和错误err，如果不出错则err==nil
if err != nil {                                            //出错退出，一般不会出错，可以写成 deData,_ := ....
panic(err)
}
fmt.Println(deData)
//[1 2 3]

base58:

直接encode/decode就好了

1
2
3
4
5
6
7
8

data := []byte{1, 2, 3}       //待编码数据
enData := base58.Encode(data) //编码
fmt.Println(enData)
//Ldp

deData, _ := base58.Decode(enData)//解码
fmt.Println(deData)
//[1,2,3]

文件存储

读取文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

//使用os.OpenFile()
file, _ := os.OpenFile("path.txt", os.O_CREATE|os.O_RDWR, 0666) //打开path.txt文件，creat若没文件则创建，rdwr以读写模式打开，0666权限
defer file.Close()                                              //延迟后关闭文件
info, _ := file.Stat()                                          //获取文件属性
reader := make([]byte, info.Size())                             //申请内存，用于存储文件内容
file.Read(reader)                                               //读取文件到reader
fmt.Printf("%s", reader)
//文件内容

//使用os.Opem()打开
//Open本质是以只读模式使用OpenFile()
file, _ := os.Open("path.txt")      //打开path.txt文件以读写模式打开
info, _ := file.Stat()              //获取文件属性
reader := make([]byte, info.Size()) //申请内存，用于存储文件内容
file.Read(reader)                   //读取文件到reader
fmt.Printf("%s", reader)
//文件内容

//使用ioutil.ReadFile()读取
str, _ := ioutil.ReadFile("path.txt") //读取文件
fmt.Printf("%s", str)
//文件内容

写入文件：

1
2
3
4
5
6
7
8
9

//使用os.OpenFile()
file, _ := os.OpenFile("path.txt", os.O_CREATE|os.O_RDWR, 0666) //打开文件
defer file.Close()
data := "你好世界"           //待写入数据
file.Write([]byte(data)) //将数据转换成[]byte类型后写入

//使用ioutil.WriteFile(),会直接覆盖原内容
data := []byte("世界")                     //待写入数据
ioutil.WriteFile("path.txt", data, 0666) //写入数据，权限666，会直接覆盖原内容

公私钥

从pem文件解析公私钥

pem目前遇见的有ecdsa和rsa两种算法，可以从密钥文件的内容直接看出，两种密钥的解析方法一样，但对于ecdsa公钥需要拼接一次

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

//解析rsa公钥
reader, _ := ioutil.ReadFile("public.pem")                    //读取公钥文件
block, _ := pem.Decode(reader)                                //pem解码
publicInterface, _ := x509.ParsePKIXPublicKey(block.Bytes)    //x509解码
publicKey := publicInterface.(*rsa.PublicKey)                 //类型断言,*号不要忘记加,报错说明密钥可能是其他类型
reader, _ = ioutil.ReadFile("private.pem")                    //读取私钥文件
block, _ = pem.Decode(reader)                                 //pem解码
privateInterface, _ := x509.ParsePKCS8PrivateKey(block.Bytes) //注意不是CS1
privateKey := privateInterface.(*rsa.PrivateKey)              //类型断言

//ecdsa解析
除了类型断言为.(*ecdsa.Public)外其他与rsa一致
//ecdsa公钥拼接
//通过x509解析出公钥publicKeyRaw后，还需要再进一步的拼接
publicKey := append(publicKeyRaw.X.Bytes(), publicKeyRaw.Y.Bytes()...) //拼接得到公钥

生成ecdsa密钥

1
2
3
4

privateKey, _ := ecdsa.GenerateKey(elliptic.P256(), rand.Reader) //生成私钥
publicKeyRaw := privateKey.PublicKey
publicKey := append(publicKeyRaw.X.Bytes(), publicKeyRaw.Y.Bytes()...) //拼接得到公钥
fmt.Println(publicKey)

生成钱包地址

钱包地址的生成需要以下几个步骤

1. 生成密钥对
2. publicHash = ripemd160(sha256(publicKey))。获取公钥哈希
3. _21byte = Version + publicHash。拼接版本号（默认写0x00）和公钥哈希
4. checkSum = sha256（sha256（_21byte））【：4】。哈希后取前4个字节
5. —25byte = —21byte + checkSum
6. address = base58(_25byte)。base58编码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

privateKey, _ := ecdsa.GenerateKey(elliptic.P256(), rand.Reader) //生成私钥
publicKeyRaw := privateKey.PublicKey
publicKey := append(publicKeyRaw.X.Bytes(), publicKeyRaw.Y.Bytes()...) //拼接得到公钥
fmt.Println(publicKey)
sha := sha256.Sum256(publicKey)
RIP := ripemd160.New()
RIP.Write(sha[:])
publicHash := RIP.Sum(nil)
_21byte := append([]byte{0x00}, publicHash...)
hash1 := sha256.Sum256(_21byte)
hash2 := sha256.Sum256(hash1[:])
checkSum := hash2[:4]
_25byte := append(_21byte, checkSum...)
address := base58.Encode(_25byte)
fmt.Printf("%x", address)

结论： 这是一份 Hexo 配置和命令索引，适合排查配置项时快速检索。
内容状态： 主要基于 2023 年资料；当前站点已经升级到 Hexo 8，执行旧命令前应与现有配置交叉确认。

配置

您可以在 _config.yml 中修改大部分的配置。

网站

其中，description主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

网址

网站存放在子目录

如果您的网站存放在子目录中，例如 http://example.com/blog，则请将您的 url 设为 http://example.com/blog 并把 root 设为 /blog/。

例如：

1
2
3
4

# 比如，一个页面的永久链接是 http://example.com/foo/bar/index.html
pretty_urls:
  trailing_index: false
# 此时页面的永久链接会变为 http://example.com/foo/bar/

目录

例如：

1
2
3
4
5

skip_render: "mypage/**/*"
# 将会直接将 `source/mypage/index.html` 和 `source/mypage/code.js` 不做改动地输出到 'public' 目录
# 你也可以用这种方法来跳过对指定文章文件的渲染
skip_render: "_posts/test-post.md"
# 这将会忽略对 'test-post.md' 的渲染

提示

如果您刚刚开始接触 Hexo，通常没有必要修改这一部分的值。

文章

相对地址

默认情况下，Hexo 生成的超链接都是绝对地址。例如，如果您的网站域名为 example.com,您有一篇文章名为 hello，那么绝对链接可能像这样：http://example.com/hello.html，它是绝对于域名的。相对链接像这样：/hello.html，也就是说，无论用什么域名访问该站点，都没有关系，这在进行反向代理时可能用到。通常情况下，建议使用绝对地址。

分类 & 标签

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

updated_option

updated_option 控制了当 Front Matter 中没有指定 updated 时，updated 如何取值：

• mtime: 使用文件的最后修改时间。这是从 Hexo 3.0.0 开始的默认行为。
• date: 使用 date 作为 updated 的值。可被用于 Git 工作流之中，因为使用 Git 管理站点时，文件的最后修改日期常常会发生改变
• empty: 直接删除 updated。使用这一选项可能会导致大部分主题和插件无法正常工作。

use_date_for_updated 选项已经被废弃，将会在下个重大版本发布时去除。请改为使用 updated_option: 'date'。

1

use_date_for_updated` | 启用以后，如果 Front Matter 中没有指定 `updated`， [`post.updated`](https://hexo.bootcss.com/docs/configuration.html) 将会使用 `date` 的值而不是文件的创建时间。在 Git 工作流中这个选项会很有用 | `true

分页

扩展

包括或不包括目录和文件

在 Hexo 配置文件中，通过设置 include/exclude 可以让 Hexo 进行处理或忽略某些目录和文件夹。你可以使用 glob 表达式 对目录和文件进行匹配。

include and exclude options only apply to the source/ folder, whereas ignore option applies to all folders.

举例：

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

# Include/Exclude Files/Folders
include:
  - ".nojekyll"
  # 包括 'source/css/_typing.css'
  - "css/_typing.css"
  # 包括 'source/_css/' 中的任何文件，但不包括子目录及其其中的文件。
  - "_css/*"
  # 包含 'source/_css/' 中的任何文件和子目录下的任何文件
  - "_css/**/*"

exclude:
  # 不包括 'source/js/test.js'
  - "js/test.js"
  # 不包括 'source/js/' 中的文件、但包括子目录下的所有目录和文件
  - "js/*"
  # 不包括 'source/js/' 中的文件和子目录下的任何文件
  - "js/**/*"
  # 不包括 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件
  - "js/test*"
  # 不包括 'source/js/' 及其子目录中任何以 'test' 开头的文件
  - "js/**/test*"
  # 不要用 exclude 来忽略 'source/_posts/' 中的文件。你应该使用 'skip_render'，或者在要忽略的文件的文件名之前加一个下划线 '_'
  # 在这里配置一个 - "_posts/hello-world.md" 是没有用的。

ignore:
  # Ignore any folder named 'foo'.
  - "**/foo"
  # Ignore 'foo' folder in 'themes/' only.
  - "**/themes/*/foo"
  # Same as above, but applies to every subfolders of 'themes/'.
  - "**/themes/**/foo"

列表中的每一项都必须用单引号或双引号包裹起来。

include 和 exclude 并不适用于 themes/ 目录下的文件。如果需要忽略 themes/ 目录下的部分文件或文件夹，可以使用 ignore 或在文件名之前添加下划线 _。

使用代替配置文件

可以在 hexo-cli 中使用 --config 参数来指定自定义配置文件的路径。你可以使用一个 YAML 或 JSON 文件的路径，也可以使用逗号分隔（无空格）的多个 YAML 或 JSON 文件的路径。例如：

1
2
3
4
5

# use 'custom.yml' in place of '_config.yml'
$ hexo server --config custom.yml

# use 'custom.yml' & 'custom2.json', prioritizing 'custom3.yml', then 'custom2.json'
$ hexo generate --config custom.yml,custom2.json,custom3.yml

当你指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 _multiconfig.yml。如果遇到重复的配置，排在后面的文件的配置会覆盖排在前面的文件的配置。这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。

例如，使用 --options 指定了两个自定义配置文件：

1

$ hexo generate --config custom.yml,custom2.json

如果 custom.yml 中指定了 foo: bar，在 custom2.json 中指定了 "foo": "dinosaur"，那么在 _multiconfig.yml 中你会得到 foo: dinosaur。

使用代替主题配置文件

通常情况下，Hexo 主题是一个独立的项目，并拥有一个独立的 _config.yml 配置文件。

除了自行维护独立的主题配置文件，你也可以在其它地方对主题进行配置。

配置文件中的 theme_config

该特性自 Hexo 2.8.2 起提供

1
2
3
4
5
6
7
8
9
10
11

# _config.yml
theme: "my-theme"
theme_config:
  bio: "My awesome bio"
  foo:
    bar: 'a'
# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'

最终主题配置的输出是：

1
2
3
4
5
6
7
8

{
  bio: "My awesome bio",
  logo: "a-cool-image.png",
  foo: {
    bar: "a",
    baz: "b"
  }
}

独立的 _config.[theme].yml 文件

该特性自 Hexo 5.0.0 起提供

独立的主题配置文件应放置于站点根目录下，支持 yml 或 json 格式。需要配置站点 _config.yml 文件中的 theme 以供 Hexo 寻找 _config.[theme].yml 文件。

1
2
3
4
5
6
7
8
9
10
11

# _config.yml
theme: "my-theme"
# _config.my-theme.yml
bio: "My awesome bio"
foo:
  bar: 'a'
# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'

最终主题配置的输出是：

1
2
3
4
5
6
7
8

{
  bio: "My awesome bio",
  logo: "a-cool-image.png",
  foo: {
    bar: "a",
    baz: "b"
  }
}

我们强烈建议你将所有的主题配置集中在一处。如果你不得不在多处配置你的主题，那么这些信息对你将会非常有用：Hexo 在合并主题配置时，Hexo 配置文件中的 theme_config 的优先级最高，其次是 _config.[theme].yml 文件，最后是位于主题目录下的 _config.yml 文件。

指令

init

1

$ hexo init [folder]

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

This command is a shortcut that runs the following steps:

1. Git clone hexo-starter including hexo-theme-landscape into the current directory or a target folder if specified.
2. Install dependencies using a package manager: Yarn 1, pnpm or npm, whichever is installed; if there are more than one installed, the priority is as listed. npm is bundled with Node.js by default.

new

1

$ hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。

1

$ hexo new "post title with whitespace"

默认情况下，Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说，Hexo 会创建一个以标题为名字的目录，并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录：

1

hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件，同时 Front Matter 中的 title 为 "About me"

注意！title 是必须指定的！如果你这么做并不能达到你的目的：

1

hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md，同时 me.md 的 Front Matter 中的 title 为 "page"。这是因为在上述命令中，hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout。

generate

1

$ hexo generate

生成静态文件。

该命令可以简写为

1

$ hexo g

publish

1

$ hexo publish [layout] <filename>

发表草稿。

server

1

$ hexo server

启动服务器。默认情况下，访问网址为： http://localhost:4000/。

deploy

1

$ hexo deploy

部署网站。

该命令可以简写为：

1

$ hexo d

render

1

$ hexo render <file1> [file2] ...

渲染文件。

migrate

1

$ hexo migrate <type>

从其他博客系统 迁移内容。

clean

1

$ hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

list

1

$ hexo list <type>

列出网站资料。

version

1

$ hexo version

显示 Hexo 版本。

选项

安全模式

1

$ hexo --safe

在安全模式下，不会载入插件和脚本。当您在安装新插件遭遇问题时，可以尝试以安全模式重新执行。

调试模式

1

$ hexo --debug

在终端中显示调试信息并记录到 debug.log。当您碰到问题时，可以尝试用调试模式重新执行一次，并 提交调试信息到 GitHub。

简洁模式

1

$ hexo --silent

隐藏终端信息。

自定义配置文件的路径

1
2
3
4
5

# 使用 custom.yml 代替默认的 _config.yml
$ hexo server --config custom.yml

# 使用 custom.yml 和 custom2.json，其中 custom2.json 优先级更高
$ hexo generate --config custom.yml,custom2.json,custom3.yml

自定义配置文件的路径，指定这个参数后将不再使用默认的 _config.yml。
你可以使用一个 YAML 或 JSON 文件的路径，也可以使用逗号分隔（无空格）的多个 YAML 或 JSON 文件的路径。例如：

1
2
3
4
5

# 使用 custom.yml 代替默认的 _config.yml
$ hexo server --config custom.yml

# 使用 custom.yml, custom2.json 和 custom3.yml，其中 custom3.yml 优先级最高，其次是 custom2.json
$ hexo generate --config custom.yml,custom2.json,custom3.yml

当你指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 _multiconfig.yml。如果遇到重复的配置，排在后面的文件的配置会覆盖排在前面的文件的配置。这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。

显示草稿

1

$ hexo --draft

显示 source/_drafts 文件夹中的草稿文章。

自定义 CWD

1

$ hexo --cwd /path/to/cwd

自定义当前工作目录（Current working directory）的路径。

结论： 本文是一份按需查询的写作手册，前半部分覆盖 Markdown，后半部分覆盖 Butterfly 外挂标签。
适用范围： Hexo + Butterfly 博客写作；示例主要整理于 2023 年，第三方标签和链接使用前需要复核。

1.Markdown语法自带格式

1.1 代码块

1
2
3
4
5
6
7
8
9
10
11
12
13

\```shell
# VSCode终端
hexo clean; hexo s
hexo clean; hexo g; hexo d
git add .; git commit -m "npm publish"; npm version patch;
git push

# Cmder终端
hexo clean && hexo s
hexo clean && hexo g && hexo d
git add . && git commit -m "npm publish" && npm version patch
git push
\```

1
2
3
4
5
6
7
8
9
10
11

# VSCode终端
hexo clean; hexo s
hexo clean; hexo g; hexo d
git add .; git commit -m "npm publish"; npm version patch;
git push

# Cmder终端
hexo clean && hexo s
hexo clean && hexo g && hexo d
git add . && git commit -m "npm publish" && npm version patch
git push

1.2 多级标题

1
2
3
4
5
6

# H1
## H2
### H3
#### H4
##### H5
###### H6

1.3 文字样式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<u>下划线演示</u>

文字**加粗**演示

文字*斜体*演示

文本`高亮`演示

文本~~删除~~线演示

<font size = 5>5号字</font>
<font face="黑体">黑体</font>
<font color=blue>蓝色</font>

<table><tr><td bgcolor=MistyRose>这里的背景色是：MistyRosen，此处输入任意想输入的内容</td></tr></table>

1.4 引用

1
2
3
4
5
6
7
8
9
10

>  Java
> 二级引用演示
> MySQL
> >外键
> >
> >事务
> >
> >**行级锁**(引用内部一样可以用格式)
>
> ....

1.5 分割线

1
2

---
***

1.6 列表(*,+,-跟空格都可以)

1.6.1 无序列表

1
2
3
4
5
6
7
8
9
10
11

* Java
* Python
* ...

+ Java
+ Python
+ ...

- Java
- Python
- ...

1.6.2 有序列表

1
2
3
4
5

# 注意后面有空格
1.
2.
3.
4.

1.7 图片

1
2
3
4

# 本地图片
<img src="/assets/pusheencode.webp" alt="示例图片" style="zoom:50%;" />
# 在线图片
![code](https://cdn.jsdelivr.net/gh/fomalhaut1998/markdown_pic/img/code.png)

1.8 表格

1
2
3
4
5

| 项目标号 | 资金     | 备注 |
| -------- | -------- | ---- |
| 1        | 100，000 | 无   |
| 2        | 200，000 | 无   |
| 3        | 300,600  | 重要 |

1.9 公式

1
2
3

$$
\Gamma(z)=\int_0^\infty t^{z-1}e^{-t}dt.
$$

2.Butterfly外挂标签

2.1 行内文本样式 text

1
2
3
4
5
6

{% u 文本内容 %}
{% emp 文本内容 %}
{% wavy 文本内容 %}
{% del 文本内容 %}
{% kbd 文本内容 %}
{% psw 文本内容 %}

1
2
3
4
5
6

1. 带 {% u 下划线 %} 的文本
2. 带 {% emp 着重号 %} 的文本
3. 带 {% wavy 波浪线 %} 的文本
4. 带 {% del 删除线 %} 的文本
5. 键盘样式的文本 {% kbd command %} + {% kbd D %}
6. 密码样式的文本：{% psw 这里没有验证码 %}

2.2 行内文本 span

1

{% span 样式参数(参数以空格划分), 文本内容 %}

1
2
3
4
5
6

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% span red, 红色 %}、{% span yellow, 黄色 %}、{% span green, 绿色 %}、{% span cyan, 青色 %}、{% span blue, 蓝色 %}、{% span gray, 灰色 %}。
- 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
{% span center logo large, Volantis %}
{% span center small, A Wonderful Theme for Hexo %}

2.3 段落文本 p

1

{% p 样式参数(参数以空格划分), 文本内容 %}

1
2
3
4
5
6

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% p red, 红色 %}、{% p yellow, 黄色 %}、{% p green, 绿色 %}、{% p cyan, 青色 %}、{% p blue, 蓝色 %}、{% p gray, 灰色 %}。
- 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
{% p center logo large, Volantis %}
{% p center small, A Wonderful Theme for Hexo %}

2.4 引用note

1
2
3
4
5
6
7
8
9
10
11
12

note:
  # Note tag style values:
  #  - simple    bs-callout old alert style. Default.
  #  - modern    bs-callout new (v2-v3) alert style.
  #  - flat      flat callout style with background, like on Mozilla or StackOverflow.
  #  - disabled  disable all CSS styles import of note tag.
  style: simple
  icons: false
  border_radius: 3
  # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
  # Offset also applied to label tag variables. This option can work with disabled note tag.
  light_bg_offset: 0

1
2
3
4
5
6
7
8

# 自带icon
{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}
# 外部icon
{% note [color] [icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note simple %}默认 提示块标签{% endnote %}

{% note default simple %}default 提示块标签{% endnote %}

{% note primary simple %}primary 提示块标签{% endnote %}

{% note success simple %}success 提示块标签{% endnote %}

{% note info simple %}info 提示块标签{% endnote %}

{% note warning simple %}warning 提示块标签{% endnote %}

{% note danger simple %}danger 提示块标签{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note modern %}默认 提示块标签{% endnote %}

{% note default modern %}default 提示块标签{% endnote %}

{% note primary modern %}primary 提示块标签{% endnote %}

{% note success modern %}success 提示块标签{% endnote %}

{% note info modern %}info 提示块标签{% endnote %}

{% note warning modern %}warning 提示块标签{% endnote %}

{% note danger modern %}danger 提示块标签{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note flat %}默认 提示块标签{% endnote %}

{% note default flat %}default 提示块标签{% endnote %}

{% note primary flat %}primary 提示块标签{% endnote %}

{% note success flat %}success 提示块标签{% endnote %}

{% note info flat %}info 提示块标签{% endnote %}

{% note warning flat %}warning 提示块标签{% endnote %}

{% note danger flat %}danger 提示块标签{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note disabled %}默认 提示块标签{% endnote %}

{% note default disabled %}default 提示块标签{% endnote %}

{% note primary disabled %}primary 提示块标签{% endnote %}

{% note success disabled %}success 提示块标签{% endnote %}

{% note info disabled %}info 提示块标签{% endnote %}

{% note warning disabled %}warning 提示块标签{% endnote %}

{% note danger disabled %}danger 提示块标签{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note no-icon %}默认 提示块标签{% endnote %}

{% note default no-icon %}default 提示块标签{% endnote %}

{% note primary no-icon %}primary 提示块标签{% endnote %}

{% note success no-icon %}success 提示块标签{% endnote %}

{% note info no-icon %}info 提示块标签{% endnote %}

{% note warning no-icon %}warning 提示块标签{% endnote %}

{% note danger no-icon %}danger 提示块标签{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' simple %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' simple %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' simple%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' simple %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' simple %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' simple %}前端最讨厌的浏览器{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' modern %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' modern %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' modern%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' modern %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' modern %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' modern %}前端最讨厌的浏览器{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' flat %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' flat %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' flat%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' flat %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' flat %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' flat %}前端最讨厌的浏览器{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13

{% note 'fab fa-cc-visa' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' disabled %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' disabled %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' disabled %}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' disabled %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' disabled %}前端最讨厌的浏览器{% endnote %}

1
2
3
4
5
6
7
8
9
10
11
12
13