这是这个博客的第一篇文章。站点基于 Hugo + PaperMod 搭建，全部是静态文件，没有数据库，也不依赖后端服务。

日常写作流程

写一篇新文章只有两步：

# 1. 新建文章（会自动带好 front matter 模板）
hugo new content posts/我的新文章.md

# 2. 本地预览，边写边看
hugo server -D

写完把 public/ 目录重新生成、传到服务器上就发布了：

hugo --minify

Front matter 说明

每篇文章开头的那段 --- 之间就是元信息：

接下来

• 在 content/posts/ 里删掉示例文章，换成你自己的内容
• 在 hugo.toml 里改站点名、署名和简介（搜「必改」）
• 公安备案号下来后，填到 [params.beian] 的 police 字段

# 到 ###### 对应一到六级标题。注意：一个页面通常只用一个 #。

强调与链接

• 加粗：**加粗**
• 斜体：*斜体*
• 删除线：~~删除线~~
• 链接：[显示文字](https://example.com)

列表

无序列表用 -，有序列表用 1.，缩进两格可以嵌套：

• 一级
  • 二级
    • 三级

代码

行内代码用反引号：npm install。

代码块用三个反引号包起来，并在开头写上语言名，会自动高亮：

function greet(name) {
  // 语言名写 js / javascript 都可以
  return `你好，${name}`;
}

console.log(greet("世界"));

def fib(n: int) -> int:
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

表格

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| a | b | c |

渲染效果：

引用

引用用 > 开头。

可以有多段。

图片

![图片描述](/images/example.png)

把图片放进 static/images/ 目录，然后按上面的路径引用即可。

分隔线

三个减号：

按工信部要求，网站在首页底部的显著位置标明备案号，并且链接到工信部备案管理系统：

<a href="https://beian.miit.gov.cn/" target="_blank" rel="noopener">
  闽ICP备2026041060号
</a>

几个容易出错的地方：

1. 必须一字不差，包括「闽ICP备」的省份简称、备 字、年份和最后的「号」。少一个「号」字都可能被判为不规范。
2. 链接要能打开。不要链接到自己站内的某个页面，也不要写成 beian.miit.gov.cn 这种没有协议头的相对地址。
3. 用 target="_blank" 新窗口打开更合理，避免用户离开站点。
4. 不要只在「关于」页面放，条款要求的是全站可见的底部位置。

公安备案号

公安联网备案通过后会拿到一个「公网安备」号，通常还要求配上警徽图标：

<a href="https://beian.mps.gov.cn/#/query/webSearch?code=44030500123456"
   target="_blank" rel="noopener">
  <img src="/images/beian-icon.png" alt="">粤公网安备44030500123456号
</a>

注意这里的 code 参数是备案号里去掉了「公网安备」和「号」的纯数字部分，具体以公安备案系统给你的链接为准。

本站怎么做的

这个站把备案信息集中在 hugo.toml 的 [params.beian] 里：

[params.beian]
    icp = "闽ICP备2026041060号"
    icpUrl = "https://beian.miit.gov.cn/"
    police = ""       # 公安备案下来后填这里
    policeUrl = ""

页脚模板读这几个值，police 为空就只显示一行 ICP，填了就自动多出一行带警徽的公安备案。改配置不用碰任何 HTML。