Sui Blog

Markdown 语法

Wed, 25 Mar 2026 12:00:00 GMT

这是一篇给本项目使用的手写语法速查模板。复制下面的示例即可。

Markdown 基础语法

标题

# 一级标题
## 二级标题
### 三级标题

强调

这是**加粗**，这是*斜体*，这是~~删除线~~。

这是加粗，这是斜体，这是~~删除线~~。

列表

- 无序项 A
- 无序项 B

1. 有序项 1
2. 有序项 2

无序项 A
无序项 B

有序项 1
有序项 2

引用

> 这是一段普通引用。

这是一段普通引用。

分隔线

---

链接与图片

[项目主页](https://github.com/suichyan/fuwari)

![示例图片](../../assets/images/banner-nacho.png)

项目主页

代码与结构

行内代码

使用 `pnpm dev` 启动开发服务器。

使用 pnpm dev 启动开发服务器。

围栏代码

```bash
pnpm install
pnpm dev
```

```nix
{ config, pkgs, ... }:
{
	services.openssh.enable = true;
}
```

pnpm install
pnpm dev

{ config, pkgs, ... }:
{
	services.openssh.enable = true;
}

代码块标题

```ts title="src/utils/math.ts"
export function add(a: number, b: number) {
	return a + b;
}
```

export function add(a: number, b: number) {
	return a + b;
}

代码块单行高亮

```ts {2}
export function add(a: number, b: number) {
	return a + b;
}
```

export function add(a: number, b: number) {
	return a + b;
}

代码块单行加减标记

```ts del={2} ins={3}
const oldValue = 1;
const newValue = 2;
console.log(newValue);
```

const oldValue = 1;
const newValue = 2;
console.log(newValue);

代码块多行与区间高亮

```ts {1,3-4}
const a = 1;
const b = 2;
const c = a + b;
console.log(c);
```

const a = 1;
const b = 2;
const c = a + b;
console.log(c);

代码块行内文本高亮

```ts "newValue"
const oldValue = 1;
const newValue = 2;
console.log(newValue);
```

const oldValue = 1;
const newValue = 2;
console.log(newValue);

代码块行内文本加减标记

```ts ins="newValue" del="oldValue"
const oldValue = 1;
const newValue = 2;
console.log(newValue);
```

const oldValue = 1;
const newValue = 2;
console.log(newValue);

代码块行号控制

```ts showLineNumbers startLineNumber=20
const a = 1;
const b = 2;
console.log(a + b);
```

```ts showLineNumbers=false
const hideLineNumber = true;
console.log(hideLineNumber);
```

const a = 1;
const b = 2;
console.log(a + b);

const hideLineNumber = true;
console.log(hideLineNumber);

代码块折叠区段

```ts collapse={1-3} collapseStyle="collapsible-start"
import { readFileSync } from "node:fs";
import { join } from "node:path";
const fileContent = readFileSync(join(process.cwd(), "README.md"), "utf-8");

console.log(fileContent.length);
```

import { readFileSync } from "node:fs";
import { join } from "node:path";
const fileContent = readFileSync(join(process.cwd(), "README.md"), "utf-8");

console.log(fileContent.length);

代码块框架样式覆盖

```bash frame="none"
pnpm build
```

pnpm build

代码块文件名注释标题（自动提取）

```ts
// src/lib/calc.ts
export const sum = (a: number, b: number) => a + b;
```

// src/lib/calc.ts
export const sum = (a: number, b: number) => a + b;

终端代码块标题

```powershell title="终端标题示例"
Write-Output "这个终端窗口带标题"
```

Write-Output "这个终端窗口带标题"

ANSI 转义序列渲染

支持通过 ANSI 转义序列在代码块中渲染彩色文本与格式。将其语言设置为 ansi 即可。

基础颜色

支持展示标准的 ANSI 8 色及其加粗、变暗变体：

```ansi
ANSI 基础颜色:
- 正常: [31m红色[0m [32m绿色[0m [33m黄色[0m [34m蓝色[0m [35m洋红[0m [36m青色[0m
- 加粗: [1;31m红色[0m [1;32m绿色[0m [1;33m黄色[0m [1;34m蓝色[0m [1;35m洋红[0m [1;36m青色[0m
- 变暗: [2;31m红色[0m [2;32m绿色[0m [2;33m黄色[0m [2;34m蓝色[0m [2;35m洋红[0m [2;36m青色[0m
```

ANSI 基础颜色:
- 正常: [31m红色[0m [32m绿色[0m [33m黄色[0m [34m蓝色[0m [35m洋红[0m [36m青色[0m
- 加粗: [1;31m红色[0m [1;32m绿色[0m [1;33m黄色[0m [1;34m蓝色[0m [1;35m洋红[0m [1;36m青色[0m
- 变暗: [2;31m红色[0m [2;32m绿色[0m [2;33m黄色[0m [2;34m蓝色[0m [2;35m洋红[0m [2;36m青色[0m

256 色调色盘

可以使用 256 色模式渲染，这里以 160 到 177 取值为例：

```ansi
256 色 (展示 160-177):
[38;5;160m160[0m [38;5;161m161[0m [38;5;162m162[0m [38;5;163m163[0m [38;5;164m164[0m [38;5;165m165[0m
[38;5;166m166[0m [38;5;167m167[0m [38;5;168m168[0m [38;5;169m169[0m [38;5;170m170[0m [38;5;171m171[0m
[38;5;172m172[0m [38;5;173m173[0m [38;5;174m174[0m [38;5;175m175[0m [38;5;176m176[0m [38;5;177m177[0m
```

256 色 (展示 160-177):
[38;5;160m160[0m [38;5;161m161[0m [38;5;162m162[0m [38;5;163m163[0m [38;5;164m164[0m [38;5;165m165[0m
[38;5;166m166[0m [38;5;167m167[0m [38;5;168m168[0m [38;5;169m169[0m [38;5;170m170[0m [38;5;171m171[0m
[38;5;172m172[0m [38;5;173m173[0m [38;5;174m174[0m [38;5;175m175[0m [38;5;176m176[0m [38;5;177m177[0m

全真 RGB 颜色与文本格式化

支持按照自定义 RGB 值渲染，以及设置文本格式，例如斜体、下划线：

```ansi
全真 RGB 颜色:
[38;2;34;139;34m森林绿 - RGB(34, 139, 34)[0m

文本格式化: [1m加粗[0m [2m变暗[0m [3m斜体[0m [4m下划线[0m
```

全真 RGB 颜色:
[38;2;34;139;34m森林绿 - RGB(34, 139, 34)[0m

文本格式化: [1m加粗[0m [2m变暗[0m [3m斜体[0m [4m下划线[0m

diff 风格加减写法

```diff
+ 这行会被标记为新增
- 这行会被标记为删除
	这是一行普通内容
```

+ 这行会被标记为新增
- 这行会被标记为删除
	这是一行普通内容

diff 写法结合语法高亮

```diff lang="js"
 function thisIsJavaScript() {
	 // 保持 JS 高亮，同时支持差异标记
-  console.log('旧代码将被移除')
+  console.log('新代码已添加')
 }
```

 function thisIsJavaScript() {
	 // 保持 JS 高亮，同时支持差异标记
-  console.log('旧代码将被移除')
+  console.log('新代码已添加')
 }

行标记标签

```ts {"A":2} del={"B":3} ins={"C":4}
const keep = true;
const removeMe = false;
const addMe = true;
```

const keep = true;
const removeMe = false;
const addMe = true;

行内文本正则标记

```ts /已[启停]用/
console.log('关键词“已启用”和“已停止”会被标记。');
```

console.log('关键词“已启用”和“已停用”会被标记。');

正则中转义斜杠

```sh /\/home\//
echo "测试" > /home/test.txt
```

echo "测试" > /home/test.txt

按代码块控制自动换行

```ts wrap=false
function 获取超长文本() {
	return '这是一段很长很长的文本，在容器宽度不足时更容易观察到自动换行的差异效果';
}
```

function 获取超长文本() {
	return '这是一段很长很长的文本，在容器宽度不足时更容易观察到自动换行的差异效果';
}

控制换行后缩进对齐

```ts preserveIndent=false
function 获取超长文本() {
	return '这是一段很长很长的文本，在容器宽度不足时更容易观察到自动换行的差异效果';
}
```

function 获取超长文本() {
	return '这是一段很长很长的文本，在容器宽度不足时更容易观察到自动换行的差异效果';
}

表格

| 命令       | 说明           |
| ---------- | -------------- |
| pnpm dev   | 启动开发服务器 |
| pnpm build | 构建生产版本   |

命令	说明
pnpm dev	启动开发服务器
pnpm build	构建生产版本

任务列表

- [x] 已完成项
- [ ] 待办项

[x] 已完成项
[ ] 待办项

HTML 写法（Markdown 中可直接使用）

<details>
	<summary>点击展开</summary>
	这里是折叠内容。
</details>

<details> <summary>点击展开</summary> 这里是折叠内容。 </details>

Markdown 进阶（通用扩展）

数学公式（KaTeX）

行内公式

勾股定理：$a^2 + b^2 = c^2$。

勾股定理：$a^2 + b^2 = c^2$。

块级公式

$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$

$$ \int_0^1 x^2,dx = \frac{1}{3} $$

Markdown 扩展功能

GitHub 仓库卡片

可以通过 ::github{repo="<owner>/<repo>"} 在文章中插入动态 GitHub 仓库卡片。

::github{repo="saicaca/fuwari"}

::github{repo="saicaca/fuwari"}

提示块

支持的类型：note、tip、important、warning、caution。

基础写法

:::note
即使快速浏览，也建议留意这条信息。
:::

:::tip
这是可选建议，能帮助你更顺利完成操作。
:::

:::important
这是关键说明，通常和正确使用方式有关。
:::

:::warning
这是风险提示，请优先确认后再执行。
:::

:::caution
该操作可能带来负面后果，请谨慎处理。
:::

:::note 即使快速浏览，也建议留意这条信息。 :::

:::tip 这是可选建议，能帮助你更顺利完成操作。 :::

:::important 这是关键说明，通常和正确使用方式有关。 :::

:::warning 这是风险提示，请优先确认后再执行。 :::

:::caution 该操作可能带来负面后果，请谨慎处理。 :::

自定义标题

:::note[自定义标题]
这是一条带自定义标题的提示块。
:::

:::note[自定义标题] 这是一条带自定义标题的提示块。 :::

GitHub 风格写法

> [!NOTE]
> 也支持 GitHub 风格的提示写法。

> [!TIP]
> 也支持 GitHub 风格的提示写法。

[!NOTE] 也支持 GitHub 风格的提示写法。

[!TIP] 也支持 GitHub 风格的提示写法。

指令语法扩展（remark-directive）

行内指令

水的化学式是 H:sub[2]O，平方写作 x:sup[2]。

水的化学式是 H:sub[2]O，平方写作 x:sup[2]。

使用Cloudflare origin rule重写端口

Sun, 22 Feb 2026 20:33:00 GMT

在服务器上配置好caddy反代后，因为没有备案只能使用高位端口来访问。但是每次访问都需要使用域名加上端口，非常麻烦。而且因为Cloudflare支持的端口有限，没法使用cf代理，服务器安全性无法得到保障。

Cloudflare支持的端口

HTTP协议	HTTPS协议
80	443
8080	2053
8880	2083
2052	2087
2082	2096
2086	8443
2095	-

在不使用80或443的情况下，访问域名就需要加上端口，例如：https://blog.suichyan.top:8443

设置Cloudflare回源规则

使用回源规则重写端口来直接访问域名

访问Cloudflare，登录，点击已经加入的域

左侧面板找到规则→概述→Origin Rule→创建规则

填写规则名称（随便编一个），选择自定义筛选表达式

配置筛选条件：

字段选择主机名
运算符选择等于
值填入反代的主机名，例如：abc.suichyan.top

如果有多个主机名，点击右侧Or，然后反复按照第四步配置

配置完主机名后，转到下面目标端口：

选择重写到...
端口号填写反代的端口，例如：54321

最后点击部署

:::warning[部署遇到配置警告？] 如果提示此规则可能不适用于您的流量，如图：

需要将对应解析的域名勾选代理状态（小黄云图标），然后再次重试部署规则即可。 :::

至此现在您可以直接通过域名访问网站不需要加端口了，例如：https://blog.suichyan.top

防止 Cloudflare 被绕过

但是你可能发现使用原来带上端口的方法仍然能够访问，这涉及到 Web 服务器的工作原理和源站保护的安全问题

这里采用最简单的方式，直接配置源服务器防火墙，反代的端口只允许Cloudflare访问

腾讯云服务器防火墙

因为在使用腾讯云，所以这里例举腾讯云防火墙的配置方法

将之前开放的端口规则删除
在任意位置编写一个cloudflare_rules.csv文件

来源,协议,端口,策略,备注
173.245.48.0/20,TCP,40000,允许,Cloudflare IPv4节点
103.21.244.0/22,TCP,40000,允许,Cloudflare IPv4节点
103.22.200.0/22,TCP,40000,允许,Cloudflare IPv4节点
103.31.4.0/22,TCP,40000,允许,Cloudflare IPv4节点
141.101.64.0/18,TCP,40000,允许,Cloudflare IPv4节点
108.162.192.0/18,TCP,40000,允许,Cloudflare IPv4节点
190.93.240.0/20,TCP,40000,允许,Cloudflare IPv4节点
188.114.96.0/20,TCP,40000,允许,Cloudflare IPv4节点
197.234.240.0/22,TCP,40000,允许,Cloudflare IPv4节点
198.41.128.0/17,TCP,40000,允许,Cloudflare IPv4节点
162.158.0.0/15,TCP,40000,允许,Cloudflare IPv4节点
104.16.0.0/13,TCP,40000,允许,Cloudflare IPv4节点
104.24.0.0/14,TCP,40000,允许,Cloudflare IPv4节点
172.64.0.0/13,TCP,40000,允许,Cloudflare IPv4节点
131.0.72.0/22,TCP,40000,允许,Cloudflare IPv4节点
2400:cb00::/32,TCP,40000,允许,Cloudflare IPv6节点
2606:4700::/32,TCP,40000,允许,Cloudflare IPv6节点
2803:f800::/32,TCP,40000,允许,Cloudflare IPv6节点
2405:b500::/32,TCP,40000,允许,Cloudflare IPv6节点
2405:8100::/32,TCP,40000,允许,Cloudflare IPv6节点
2a06:98c0::/29,TCP,40000,允许,Cloudflare IPv6节点
2c0f:f248::/32,TCP,40000,允许,Cloudflare IPv6节点

添加服务器的防火墙规则

选择导入规则
选择追加导入
选择刚才编写的csv文件

再次尝试能否带端口访问，如果不能就是配置成功了

:::tip[完成与验证] 最后检查能否不带端口访问网页。
如果能，那么恭喜你🎉，网站成功被 Cloudflare 代理并自动重写到了目标端口！ :::

NixOS安装指南

Fri, 06 Feb 2026 23:33:00 GMT

Windows安装前准备

调整时间设置

:::note[关于时间错乱] Linux把主板时间改成标准UTC时间，然后根据系统设置的时区对UTC时间进行加减后显示出来。Windows直接读取主板时间显示出来，所以此时你Windows显示的时间就变成了UTC时间，表面上看就像是windows时间错乱了。 :::

PowerShell 管理员权限运行：

Reg add HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation /v RealTimeIsUniversal /t REG_DWORD /d 1

进入Live CD

默认无密码自动登录，使用命令切换到root用户：

sudo -i

连接网络

安装过程几乎肯定需要有效的网络连接。无网络的安装是可行的, 但是可用的软件包集合是受限的。

有线网络

使用网线连接电脑，亦或是使用USB共享网络
使用命令确认网络连接：

ip a #查看网络连接信息
ping bilibili.com -c 4 # 确认网络正常
ping 119.29.29.29 -c 4  # 腾讯 DNSPod，不通请检查网络连接

WiFi连接

NixOS 默认使用wpa_supplicant作为无线守护程序。
使用命令进入：

sudo systemctl start wpa_supplicant  # 启动服务
sudo wpa_cli  # 进入 wpa 命令行交互模式

接着进入交互模式：

> add_network
0
> set_network 0 ssid "你家 WIFI 的 SSID"
OK
> set_network 0 psk "WIFI 密码"
OK
> set_network 0 key_mgmt WPA-PSK
OK
> enable_network 0
OK

如果你成功连接，执行完如上的命令后你将得到类似下面的一条message：

<3>CTRL-EVENT-CONNECTED - Connection to 32:85:ab:ef:24:5c completed [id=0 id_str=]

这个时候你就可以通过quit命令来退出wpa_cli。
再次检测网络连接：

ip a #查看网络连接信息
ping bilibili.com -c 4 # 确认网络正常
ping 119.29.29.29 -c 4  # 腾讯 DNSPod，不通请检查网络连接

更换频道

:::note[关于 Flake 与国内网络] 由于 Flake 使用 Git 仓库 URL 作为 inputs，较难直接使用国内的 Channel 镜像。因此在我们尚未配置好完美的代理环境前，本指南暂时不使用 Flake，以免因为网络问题卡在半路。 :::

:::warning[警告] 在订阅系统版本时请指定系统版本，一般指定当前的最新稳定版。 :::

nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-25.11 nixos
nix-channel --update  # 更新并解包频道

分区与格式化

NixOS 安装程序附带多种分区工具。
以下示例使用cfdisk，但也提供fdisk、gdisk、parted和cgdisk。

首先，我们使用lsblk命令查看分区情况：

lsblk -pf  #查看当前分区情况
fdisk -l /dev/想要查询详细情况的硬盘  #小写字母l，查看详细分区信息
cfdisk /dev/nvme0n1 #选择自己要使用的硬盘进行分区

格式化分区

再次查看分区情况

lsblk -pf #查看分区情况
fdisk -l /dev/想要查询详细情况的硬盘  #小写字母l，查看详细分区信息

格式化efi分区

mkfs.fat -F 32 /dev/nvme0n1p1（EFI分区名）

格式化btrfs根分区

mkfs.btrfs /dev/nvme0n1p2（根分区名）
#加上-f参数可以强制格式化

创建btrfs子卷

:::note[什么是 Btrfs 子卷？] 子卷是 Btrfs 的一个重要特性，主要用于快照管理。通常至少要创建 root 子卷（存放系统文件）和 home 子卷（存放用户文件），根据命名规范取名为 @ 和 @home。由于这两者是平级关系，所以创建 @ 的快照时不会包含 @home。这样就可以做到单独恢复系统文件，而不影响用户数据。 :::

挂载

mount -t btrfs /dev/nvme0n1p2（根分区名） /mnt

创建子卷

btrfs subvolume create /mnt/@root
btrfs subvolume create /mnt/@home
btrfs subvolume create /mnt/@nix

可选：确认

btrfs subvolume list -p /mnt

取消挂载，因为我们要重新挂载子卷：

umount /mnt

正式挂载

挂载root子卷

mount -o subvol=@root,compress-force=zstd /dev/nvme0n1p2 /mnt

:::tip[压缩算法选择] 使用 compress-force 而不是 compress，是因为前者会让 Zstd 算法自己判断是否可压缩，这比内核自带的快速启发式检查（compress）压缩率更高。如果您的磁盘空间非常有限，可以指定一个更高的压缩等级，例如 compress-force=zstd:7。Zstd 可选的等级范围是 -15 (快) 到 15 (慢，高压缩率)，默认是 3。 :::

挂载home子卷

mount --mkdir -o subvol=@home,compress-force=zstd /dev/nvme0n1p2 /mnt/home

挂载nix子卷

mount --mkdir -o subvol=@nix,noatime,compress-force=zstd /dev/nvme0n1p2 /mnt/nix

挂载efi分区（ESP）

mount --mkdir /dev/nvme0n1p1 /mnt/efi

复查挂载情况

df -h

编辑系统配置

使用以下命令生成基础配置：

nixos-generate-config --root /mnt

:::tip[用户密码准备] 马上我们要编辑系统的核心配置，如果你不想配置好系统启动后无法登录，我们需要提前生成密码哈希值： :::

mkpasswd -m sha-512

注意： 运行后输入你的密码，它会输出一串极其复杂的哈希字符串（例如 $6$F...），请把这串字符复制或拍照记录下来，下一步编辑配置时会用到！

然后编辑配置：

nano /mnt/etc/nixos/configuration.nix

{ config, lib, pkgs, ...}:
{
    imports = [ ./hardware-configuration.nix ];
    boot.loader = {
        grub = {
            enable = true; #启用GRUB
            default = "saved";
            device = "nodev"; # `nodev`表示将生成一个 GRUB 引导菜单，但不会实际安装 GRUB。
            efiSupport = true; #启用EFI支持
            useOSProber = true; # 使用OSprober搜索其他系统
            extraConfig = ''
                GRUB_SAVEDEFAULT=true
            '';
        };
        efi = {
            canTouchEfiVariables = true;
            efiSysMountPoint = "/efi";
        };
    };
    networking = {
        hostName = "NixOS";
        networkmanager.enable = true;
    };

    time.timeZone = "Asia/Shanghai";
    i18n.defaultLocale = "en_US.UTF-8";

    # ==== Display Manager ====
    services.greetd.enable = true;
    services.greetd.settings = {
        default_session = {
            command = "${pkgs.greetd.tuigreet}/bin/tuigreet --cmd niri";
            user = "greeter";
        };
    };

    # ==== Window Manager ====
    programs.niri.enable = true;

    # ==== Audio ====
    services.pipewire = {
        enable = true;
        alsa.enable = true;
        alsa.support32Bit = true;  # 需要 32 位音频支持可保留
        pulse.enable = true;       # 兼容 PulseAudio
        jack.enable = true;        # 需要 JACK 可保留，不需要可删
    };

    # ==== User ====
    users.mutableUsers = false; # 让用户完全由配置控制
    users.users.sui = {
        isNormalUser = true;
        hashedPassword = "$6$F1JgV....$kK1R3z....";
        extraGroups = [ "wheel" "networkmanager" ];
    };

    environment.systemPackages = with pkgs; [
        neovim
    ];

    nix.settings.substituters = [ "https://mirrors.ustc.edu.cn/nix-channels/store" ];
    system.stateVersion = "25.11";  # 不要改动
}

对于hardware-configuration.nix不需要太多改动。

先获取分区uuid

blkid

填入各子卷的挂载参数以及uuid修改/boot为/efi

# 省略其余配置
fileSystem = {
            "/" = {
                device = "...";
                fsType = "btrfs";
                options = [ "subvol=@root" "compress-force=zstd" ];
            };
            "/home" = {
                device = "...";
                fsType = "btrfs";
                options = [ "subvol=@home" "compress-force=zstd" ];
            };
            "/nix" = {
                device = "...";
                fsType = "btrfs";
                options = [ "subvol=@nix" "noatime" "compress-force=zstd" ];
            };
            "/efi" = {
                device = "...";
                fsType = "vfat";
            };
# 省略其余配置
}

部署系统

sudo nixos-install --option substituters https://mirrors.ustc.edu.cn/nix-channels/store

最后只要重启电脑，祈求它能正常进入系统