这是一篇的示例文章：在AI的辅助下整理了一些信息。前半部分把本站常用的 Markdown 语法演示一遍（同时给出源码），后半部分是给这个博客主题整理的运维指南。
一、标题与文本格式
这是三级标题下面的正文。支持 加粗、斜体、删除线、行内代码、链接、以及脚注式强调等基础格式。
**加粗** *斜体* ~~删除线~~ `行内代码` [链接](https://astro.build)二、列表
- 无序列表项一
- 无序列表项二
- 嵌套项
- 有序列表
- 第二项
任务清单（Obsidian 里勾选，本站按普通列表渲染）：
- 部署博客
- 写第二篇文章
- 无序列表项 - 嵌套项
1. 有序列表
- [x] 已完成- [ ] 未完成三、引用与提示块
普通引用：写点值得强调的话。
GitHub 风格提示块：
NOTE这是一个 NOTE 提示。
WARNING这是一个 WARNING 警告。
主题风格的提示块（支持自定义标题）：
提示这是
note类型提示块。
TIP这是
tip类型。
IMPORTANT这是
important类型。
CAUTION这是
caution类型。
> [!NOTE]> GitHub 风格提示。
:::note[自定义标题]主题风格提示块。:::还可以做「折叠剧透」：答案是
四、代码块与代码组
普通代码块（带文件名、行号、高亮第 2 行、插入第 3 行）：
export const config = { framework: "Mizuki", enhanced: true,};超长代码块会自动折叠，也可以手动 collapse={1-3}。
多个相关代码块可以做成标签页（VitePress 风格 ::: code-group）：
export const framework = "Mizuki";pnpm build```ts title="config.ts" showLineNumbers {2} ins={3}export const config = { framework: "Mizuki", enhanced: true };```
::: code-group labels=[TypeScript, Shell]```tsexport const framework = "Mizuki";``````bashpnpm build```:::五、表格
| 功能 | 命令 | 备注 |
|---|---|---|
| 本地开发 | pnpm dev | localhost:3000 |
| 构建 | pnpm build | 产出 dist/ |
| 发布 | git push | 触发自动部署 |
六、图片
本地上传的图片放在文章目录或 public/images/，远程图直接写网址。可以在 alt 里用 w-N% 控制宽度（1%–100%），用 title 显示图注：
两张及以上连续的独立图片会自动组成响应式图库：
七、数学公式
行内公式 ，独立公式：
化学式（KaTeX mhchem）：
八、图表
Mermaid 流程图：
PlantUML（会把源码编码后发到公共服务器渲染，别放敏感内容）：
```plantuml@startumlAlice -> Bob: Hello@enduml```九、链接与卡片
站内文章用 Wiki Link，单独一行会渲染成文章卡片：
行内写法则是普通站内链接，也可指定锚点：见 这篇文章。
GitHub 仓库卡片：
[[尝试写第一篇]]
::github{repo="LyraVoid/Mizuki"}十、文章 frontmatter 速查
只有 title 和 published 必填，其余按需：
---title: 标题published: 2026-09-27 # 必填updated: 2026-09-28 # 可选description: 摘要（用于卡片和 SEO）tags: [随笔, 技术]category: 随笔image: api # 封面：api=随机图 / ./cover.webp / /images/x.webp / https://…draft: false # true=草稿，不上线pinned: false # 置顶encrypted: false # true + password 可实现"浏览器端加密"---博客运维指南
下面是通用流程（不含任何服务器地址、密钥等敏感信息）。
1. 整体架构
要点：服务器不参与构建，只做静态托管；所以 CPU 再弱也不影响发文章。
2. 日常发布
cd <仓库目录>git add -Agit commit -m "post: 标题"git push推送后会自动上线。也可以到仓库 Actions 页面手动点 Run workflow。
3. 常见操作
| 目的 | 做法 |
|---|---|
| 撤回上一次部署 | 服务器上把 dist 软链切回上一个 releases/ 目录 |
| 只改内容不改代码 | 编辑 src/content/posts/ 或 src/data/，push 即可 |
| 手动刷新追番 | 到 Actions 页 Run workflow（或等每日定时任务） |
| 关闭某个特色页面 | src/config/siteConfig.ts 里对应开关设为 false |
4. 故障排查速查
| 现象 | 可能原因 | 处理 |
|---|---|---|
git push 超时 / 握手失败 | 本地网络到 GitHub 不通 | 检查网络/代理，重试或切换线路 |
| Actions 秒失败在依赖安装 | 版本不匹配 | 看报错日志，多为工具链版本问题 |
| 构建失败 | 内容有语法错误 | 看失败步骤日志，定位到具体文件 |
| 部署失败在 SSH 一步 | 部署密钥未配置 | 检查服务器 authorized_keys 与仓库 Secret |
| 网站 403 | 站点根目录指错 | 应指向构建产物的 dist/ 目录 |
| 页面空白/404 | 产物缺失 | 确认 Actions 成功，检查服务器发布目录 |
5. 安全
- 不把密码、密钥、Token 写进文章（PlantUML、MDX、公共图片同样会公开）。
- 服务器地址、SSH 端口、账号之类的信息，不出现在公开文章里。
- 需要私密内容时用文章加密，静态站的加密是浏览器端的，不放高度敏感信息。
- 本地私钥文件不放进仓库（
.gitignore已忽略常见私钥文件名）。
6. 发布前检查
- frontmatter 的
title/published齐全 - 图片路径、大小写、远程 URL 正确
- 提示块 / 网格 / 代码块 / 图表块正确闭合
- 敏感信息是否写进正文
-
draft是否已改为false
这篇既是示例，也算是备忘吧。以后加新语法或新流程再回来补信息。
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时