Fqzlrのblog

写一篇文章#

文章放在内容仓 content/posts/ 下，Markdown 即可，也支持 MDX。最小 frontmatter 长这样：

1
---
2
title: 我的第一篇文章
3
published: 2026-08-10
4
description: 一句话摘要，会显示在列表和分享卡片里
5
tags: [随笔]
6
category: 生活
7
---

frontmatter 之后就是正文。几条本站约定：

• 子目录归类：文章按主题放进子文件夹，如 posts/tech/、posts/philosophy/，URL 会带上目录名（/posts/tech/xxx/）
• category 用大类（如”技术教程”），细分交给 tags，标签页会自动聚合
• 草稿：frontmatter 加一行 draft: true，文章只进构建不进正式列表
• 想新建文章时，主题仓的 pnpm new-post 文件名 可以生成骨架，再挪进对应子目录

Markdown 扩展语法#

除了标准 Markdown，Shirone 还内置几组扩展，写教程尤其好用：

提示块（admonition），支持 tip / warning / details 等类型，details 默认折叠：

1
:::tip[小贴士]
2
这是提示内容
3
:::

此外还有 Mermaid 流程图、数学公式、代码块增强（复制按钮、行高亮）、图片画廊，直接按各自的标准语法写即可，无需配置。

发瞬间（动态）#

瞬间是轻量的短内容，类似说说。文件放 content/moments/，命名 YYYY-MM-DD-标识.md：

1
---
2
content: 网站换新背景图了
3
date: 2026-08-08 21:30:00
4
location: 河南-郑州
5
images:
6
  - src: https://tu.fqzlr.com/bg.webp
7
    alt: 新背景图
8
---

带 images 就是图文瞬间，纯文字则只写 content。侧栏的”瞬间”页面按时间倒序展示。

维护数据页面#

几类”列表型”页面由内容仓 data/ 下的 TypeScript 文件驱动，改完同样 pnpm content:sync 生效：

双仓日常节奏#

采用内容分离模式后，我的日常流程是：

1
# 内容仓里写作（.env 指向本地内容仓时同步是实时的）
2
pnpm content:sync      # 物化最新内容到主题
3
pnpm dev               # 本地预览
4
pnpm content:validate  # 发布前校验
5
git push               # 内容仓与主题仓各自推送

内容仓 push 之后，如果部署流水线绑定的是主题仓，记得主题仓也要触发一次构建才能带上最新内容。

搜索与 SEO#

站点自带 Pagefind 全文搜索（pnpm build 时自动建立索引，本地 pnpm dev 下搜不到是正常的，构建后才有）；RSS 与 sitemap 默认输出，配合 site.yaml 里的正式网址，搜索引擎收录无需额外操作。

到这里，安装、设置、使用三篇就齐了。建站只是开始，持续写下去才是博客的意义。