是什么#

Markdown 文件最开头用 --- 包裹的一段 YAML 格式数据,叫做 ==Frontmatter==（前置信息/元数据）

1
---
2
title: docker compose容器编排  # 标题
3
published: 2026-05-06
4
updated: 2026-05-06
5
description: 文章描述         # 描述
6
tags: [YAML, Frontmatter, 元数据]
7
category: 知识扩展
8
author: 久棹           # 作者
9
---

📌 注意：它不是 ```yaml 代码块！

Frontmatter 的 --- 是裸写的,直接放在文件第 1 行,前后不加反引号

格式规则#

YAML 语法速查#

badge 文章角标#

文章列表卡片上显示的状态小标签,不是标准字段,是自己和程序约定好的”暗号”

1
---
2
title: "docker stack 部署应用实战"
3
---

💡 角标本质就是你自己定义的分类标记,想加什么类型都可以,只要代码里对应处理就行

cover 封面的工作方式#

• 写图片的文件名即可：cover: counter-app-cover.png
• 程序读取后自动拼完整路径：./笔记名/counter-app-cover.png
• 也支持 CSS 渐变当纯色背景：cover: "linear-gradient(135deg, #667eea 0%, #764ba2 100%)"

1
---
2
title: "docker stack 部署应用实战"
3
image: "api"
4
# 封面图放在同目录的 笔记名/ 文件夹下,程序自动读取
5
---

articleId 文章唯一标识#

给每篇文章一个身份证号,跟文件名解耦

1
---
2
title: "docker stack 部署应用实战"
3
---

新建文章时程序帮你生成一串 UUID（如 crypto.randomUUID()）,你不用手写

自建博客实例#

1
---
2
title: docker stack 部署应用实战
3
description: 在 Swarm 集群上使用 docker stack 部署 Flask + Redis 计数器应用
4
published: 2026-05-06
5
updated: 2026-05-06
6
tags: [YAML, Frontmatter, 元数据]
7
category: 知识扩展
8
author: 久棹
9
image: "api"
10
---

💡 这就是你以后搭博客时,Frontmatter 的最小可用集,每个 md 文件顶部写好这些,程序就能自动生成文章列表、标签页、搜索索引

中文值需要加引号吗❓️#

==大部分情况不需要==,但以下情况必须加引号：

💡 保险做法：中文描述类字段（title、description、summary）一律加双引号,省心

description 和 summary 并存还是二选一❓️#

两个可以并存,各有分工：

1
---
2
title: "docker stack 部署应用实战"
3
description: "在 Docker Swarm 集群上使用 docker stack 命令部署 Flask + Redis 计数器应用,涵盖镜像构建、私有仓库推送、滚动更新与 routing mesh 负载均衡"
4
---

如果只保留一个,优先用 description,它兼顾 SEO 又能当摘要用

⚠️ 常见坑#

• Frontmatter 必须从第 1 行第 1 列开始写 ---,前面不能有空行或空格
• 结束的 --- 不能忘,否则整个文件都被当成 YAML 解析
• YAML 对缩进敏感,子级必须缩进 2 个空格（不要用 Tab）
• 不要在 Frontmatter 里写 markdown 语法,它是纯 YAML
• 中文值含 ： # & 等特殊字符时必须加双引号,否则 YAML 解析报错