WYZ

欢迎来到 WYZ の拾忆录

这里是我的私人记忆博物馆。我会在这里整理技术学习的点滴、记录生活中的灵光一闪，也会写下那些不想被时间冲走的随笔与感悟。愿这些文字，能成为你我共鸣的频率。

了解本站

标签

WYZ

欢迎来到 WYZ の拾忆录

这里是我的私人记忆博物馆。我会在这里整理技术学习的点滴、记录生活中的灵光一闪，也会写下那些不想被时间冲走的随笔与感悟。愿这些文字，能成为你我共鸣的频率。

了解本站

标签

AI Astro EdgeOne GitHub Actions LOGO Markdown Mizuki Sakura 部署

WYZ

欢迎来到 WYZ の拾忆录

这里是我的私人记忆博物馆。我会在这里整理技术学习的点滴、记录生活中的灵光一闪，也会写下那些不想被时间冲走的随笔与感悟。愿这些文字，能成为你我共鸣的频率。

了解本站

标签

AI Astro EdgeOne GitHub Actions LOGO Markdown Mizuki Sakura 部署

1172 字

3 分钟

Muzuki使用指南

2026-06-04

指南

Mizuki

/

Markdown

Muzuki使用指南#

这篇文章把原先分散的多篇示例文章整理成了一份可直接查阅的总指南，方便你在一个页面里快速找到最常用的内容写作方法。

文章 Front-matter#

每篇文章最上方都可以写一段 Front-matter，用来声明标题、发布时间、描述、标签等元信息。

1
---
2
title: My First Blog Post
3
published: 2023-09-09
4
description: This is the first post of my new Astro blog.
5
image: ./cover.jpg
6
tags: [Foo, Bar]
7
category: Front-end
8
draft: false
9
---

字段	说明
`title`	文章标题。
`published`	文章发布时间。
`updated`	文章更新时间。
`pinned`	是否将文章置顶到列表顶部。
`priority`	置顶文章的优先级，值越小优先级越高。
`description`	文章简介，会显示在首页或列表页卡片中。
`image`	文章封面路径。可以是网络图片、`public` 目录下的图片，或相对于当前 Markdown 文件的本地图片。
`tags`	文章标签。
`category`	文章分类。
`author`	文章作者。
`sourceLink`	文章来源或参考链接。
`licenseName`	文章内容的许可名称。
`licenseUrl`	许可协议链接。
`draft`	是否为草稿。草稿不会在文章列表中显示。
`alias`	自定义文章访问别名。
`encrypted`	是否启用文章加密。
`password`	解锁文章所需的密码。
`passwordHint`	密码提示文本。

文章文件放在哪里#

文章文件默认放在 src/content/posts/ 目录下。你也可以继续创建子目录，把文章和对应素材整理得更清晰。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.webp
5
    └── index.md

草稿文章#

如果一篇文章还没写完，可以先把它标记成草稿：

1
---
2
title: Draft Example
3
published: 2024-01-11T04:40:26.381Z
4
tags: [Markdown, Blogging, Demo]
5
category: Examples
6
draft: true
7
---

草稿文章不会对普通访客显示，等内容准备完成后，把 draft 改成 false 即可发布。

加密文章#

如果你希望某篇文章只有输入密码后才能查看，可以这样写：

1
---
2
title: My Private Post
3
published: 2024-01-15
4
encrypted: true
5
password: "my-secret-password"
6
passwordHint: "Hint: The password is my dog's name"
7
---

你也可以额外配置更易读的访问路径：

1
---
2
title: My Special Article
3
published: 2024-01-15
4
alias: "my-special-article"
5
tags: ["Example"]
6
category: "Technology"
7
---

启用加密后，页面通常会显示标题、密码提示、输入框和解锁按钮。输入正确密码后，文章内容才会展示出来。

Markdown 基础语法#

段落与换行#

Markdown 中，段落通常通过空行分隔。对应的 HTML 标签是 <p>。

1
这是第一段。
2

3
这是第二段。

如果你只是换行而没有插入空行，Markdown 往往仍然会把它视作同一段文字。想要在同一段内强制换行，可以在行尾添加两个空格，或直接写 <br />。

1
这一行后面有两个空格。
2
所以这里会换行。
3

4
这一行使用了 HTML 标签。<br />
5
这里也会换行。

标题#

Markdown 常见的标题写法有两种：Setext 风格和 ATX 风格。

1
This is an H1
2
=============
3

4
This is an H2
5
-------------

1
# This is an H1
2
## This is an H2
3
### This is an H3
4
#### This is an H4
5
##### This is an H5
6
###### This is an H6

引用#

1
> 这是一个引用段落。
2
> 你可以在每一行前都写 `>`。

这是一个引用段落。你可以在每一行前都写 >。

列表#

无序列表可以用 -、* 或 +：

1
- 列表项一
2
- 列表项二
3
- 列表项三

有序列表使用数字加英文句点：

1
1. 第一步
2
2. 第二步
3
3. 第三步

代码块#

围栏代码块是最常见的写法：

1
```javascript
2
function test() {
3
  console.log("notice the blank line before this function?");
4
}
5
```

分隔线#

1
---
2
***
3
___

表格#

1
| 名称 | 类型 | 说明 |
2
| :--- | :---: | ---: |
3
| title | string | 文章标题 |
4
| tags | string[] | 文章标签 |
5
| draft | boolean | 是否草稿 |

名称	类型	说明
title	string	文章标题
tags	string[]	文章标签
draft	boolean	是否草稿

行内元素#

链接#

1
[OpenAI](https://openai.com/ "OpenAI Homepage")

也支持引用式链接：

1
这是一个 [示例链接][id]。
2

3
[id]: https://example.com/ "Title"

强调#

1
*斜体文本*
2
**加粗文本**
3
***同时加粗和斜体***

行内代码#

1
使用 `printf()` 函数输出内容。

图片#

1
![Alt text](./cover.webp "Image Title")

也支持引用式图片：

1
![Alt text][cover]
2

3
[cover]: ./cover.webp "Image Title"

删除线#

1
~~这段文字会显示为删除线~~

自动链接与转义#

1
<https://github.com/emn178/markdown>
2
<example@example.com>
3
\*literal asterisks\*
4
\# not a heading

内联 HTML#

对于 Markdown 语法未覆盖的结构，可以直接写 HTML。

1
<div class="note">
2
  <strong>提示：</strong> 这里是一段自定义 HTML。
3
</div>

Markdown 扩展功能#

GitHub 仓库卡片#

你可以在文章中加入动态的 GitHub 仓库卡片：

LyraVoid

/

Mizuki

Waiting for api.github.com...

00K

0K

Waiting...

对应写法：

1
::github{repo="LyraVoid/Mizuki"}

提示块（Admonitions）#

当前支持的提示块类型有：note、tip、important、warning、caution。

NOTE
这里适合放读者即使快速浏览也不应错过的信息。

TIP
这里适合补充一些能帮助读者更顺利完成操作的小建议。

IMPORTANT
这里适合放与最终结果密切相关的重要说明。

WARNING
这里适合提醒读者注意潜在风险或高优先级问题。

CAUTION
这里适合说明某个操作可能带来的负面后果。

也支持自定义标题：

我的自定义标题
这是一条带有自定义标题的提示。

GitHub 风格语法同样可用：

TIP
GitHub 风格的提示块语法也受支持。

Spoiler 折叠文本#

正文示例：这里是一段被折叠的内容。

Mermaid 图表示例#

流程图#

graph TD A[Start] --> B{Condition Check} B -->|Yes| C[Process Step 1] B -->|No| D[Process Step 2] C --> E[Subprocess] D --> E E --> F{Another Decision} F -->|Option 1| G[Result 1] F -->|Option 2| H[Result 2] F -->|Option 3| I[Result 3] G --> J[End] H --> J I --> J

时序图#

sequenceDiagram participant User participant WebApp participant Server participant Database User->>WebApp: Submit Login Request WebApp->>Server: Send Auth Request Server->>Database: Query User Credentials Database-->>Server: Return User Data Server-->>WebApp: Return Auth Result

甘特图#

gantt title Website Development Project Timeline dateFormat YYYY-MM-DD section Design Phase Requirements Analysis :a1, 2023-10-01, 7d UI Design :a2, after a1, 10d section Development Phase Frontend Development :b1, 2023-10-20, 15d Backend Development :b2, after a2, 18d

类图#

classDiagram class User { +String username +String email +login() +logout() } class Article { +String title +String content +publish() } User "1" -- "*" Article : writes

状态图#

stateDiagram-v2 [*] --> Draft Draft --> UnderReview : submit UnderReview --> Approved : approve Approved --> Published : publish Published --> Archived : archive

饼图#

pie title Website Traffic Sources Analysis "Search Engines" : 45.6 "Direct Access" : 30.1 "Social Media" : 15.3 "Referral Links" : 6.4 "Other Sources" : 2.6

在文章中嵌入视频#

把 YouTube、Bilibili 或其他平台提供的嵌入代码直接复制到 Markdown 文件中，就可以在文章里展示视频内容。

1
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

YouTube#

Bilibili#

总结#

如果你正在维护自己的 Mizuki 博客，这篇文章可以当作一份统一入口的速查手册。平时最常用的 Front-matter、草稿、加密、Markdown、扩展语法、Mermaid 和视频嵌入，都可以直接从这里复制和调整。

如果这篇文章对你有帮助，欢迎分享给更多人！

Muzuki使用指南

https://mizuki.mysqil.com/posts/mizuki-guide/

作者

WYZ

发布于

2026-06-04

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

为什么我花了这么多时间设计一个头像

Somthing for nothing

WYZの拾忆录

Muzuki使用指南#

文章 Front-matter#

文章文件放在哪里#

草稿文章#

加密文章#

Markdown 基础语法#

段落与换行#

标题#

引用#

列表#

代码块#

分隔线#

表格#

行内元素#

链接#

强调#

行内代码#

图片#

删除线#

自动链接与转义#

内联 HTML#

Markdown 扩展功能#

GitHub 仓库卡片#

提示块（Admonitions）#

Spoiler 折叠文本#

Mermaid 图表示例#

流程图#

时序图#

甘特图#

类图#

状态图#

饼图#

在文章中嵌入视频#

YouTube#

Bilibili#

总结#

目录