如何正确发布文章

错过了落日余晖，还可以期待满天繁星。#

一、文件夹型结构#

创建文件夹:
- 在 src/content/posts 目录下创建一个新的文件夹，文件夹名应该具有描述性，例如my-complex-post。
- 在新创建的文件夹中创建一个名为xxxx.md的文件，其中xxxx是文章的唯一标识符，通常使用日期格式,eg:20251123.md。
- 创建cover.png文件，作为文章的封面图片。

编写文章:

在xxxx.md文件中编写文章内容，使用markdown语法。

基本语法如下:

语法：

1
title: "如何正确发布文章"  文章的标题必须写
2
published: 2025-11-23   文章发布日期必须写
3
pinned: false           是否置顶文章
4
description: "文章的发布方式"  描述你的文章
5
tags: [文章，文档，文件夹]     文章标签
6
category: "技巧"        文章分类，
7
licenseName: "CC BY 4.0"  文章许可证（可有可无）
8
author: "QTY"          作者
9
image: "./cover.png"      封面图片（路径）
10
sourceLink: "https://link3.cc/qtya"    来源链接（可有可无）
11
draft: false            是否为草稿
12
date: 2025-01-20  文章创建日期
13
pubDate: 2025-01-20    文章发布日期（可有可无）
14

15
使用draft字段来管理文章状态：
16
  draft: true - 文章不会在生产环境中显示
17
  draft: false - 文章正常发布
18

19
许可证设置——常见的许可证名称：
20
  "MIT"
21
  "Apache-2.0"
22
  "CC BY 4.0"
23
  "CC BY-SA 4.0"
24
  "Unlicensed"

引用某篇文章:
- 要在博客页面或其他页面中链接到你的文章，可以使用标准的 html中a标签的href属性:
  202x-xx-xx
  
  注意：确保链接的href属性指向正确的文章路径。

二、文件结构#

创建文件:
- 在 src/content/posts 目录下创建一个名为xxxx.md的文件，其中xxxx是文章的唯一标识符，通常使用日期格式,eg:20251123.md。

编写文章:

在xxxx.md文件中编写文章内容，使用markdown语法。

基本语法如下:

语法：

1
title: "如何正确发布文章"  文章的标题必须写
2
published: 2025-11-23   文章发布日期必须写
3
pinned: false           是否置顶文章
4
description: "文章的发布方式"  描述你的文章
5
tags: [文章，文档，文件夹]     文章标签
6
category: "技巧"        文章分类，
7
licenseName: "CC BY 4.0"  文章许可证（可有可无）
8
author: "QTY"          作者
9
image: "./cover.png"      封面图片（路径）
10
sourceLink: "https://link3.cc/qtya"    来源链接（可有可无）
11
draft: false            是否为草稿
12
date: 2025-01-20  文章创建日期
13
pubDate: 2025-01-20    文章发布日期（可有可无）
14

15
使用draft字段来管理文章状态：
16
  draft: true - 文章不会在生产环境中显示
17
  draft: false - 文章正常发布
18

19
许可证设置——常见的许可证名称：
20
  "MIT"
21
  "Apache-2.0"
22
  "CC BY 4.0"
23
  "CC BY-SA 4.0"
24
  "Unlicensed"

引用某篇文章:
- 要在博客页面或其他页面中链接到你的文章，可以使用标准的 html中a标签的href属性:
  202x-xx-xx
  
  注意：确保链接的href属性指向正确的文章路径。
文章通用开头（复制修改即可）：

1
---
2
title: "如何正确发布文章"
3
published: 2025-11-23
4
pinned: false
5
description: "文章的发布方式"
6
tags: [文章，文档，文件夹]
7
category: "技巧"
8
licenseName: "CC BY 4.0"
9
author: "QTY"
10
image: "./cover.png"
11
sourceLink: "https://docs.mizuki.mysqil.com/press/file/"
12
draft: false
13
date: 2025-11-22
14
pubDate: 2025-11-23
15
<!-- 给文章加锁 -->
16
encrypted: false
17
password: "0723"
18

19
---

博客主体文字更改文件：zh_CN.ts文件。

6.mizuki本地一键启动脚本：

三、常见markdown语法#

双反引号内加入代码可实现： daimagaoliang

键入“（`（注意去掉中间）typescript title=（引号内为路径）“src/config.ts”可实现：代码高亮群显示：

1
export const announcementConfig: AnnouncementConfig = {
2
  title: "网站公告",
3
  content: "欢迎访问我的博客！这里会分享技术文章和生活感悟。",
4
  closable: true,
5
  link: {
6
      enable: true,
7
      text: "关于我",
8
      url: "/about/",
9
      external: false,
10
  },
11
};

3.图片插入方法以及同文章链接： // 插入id锚点 2.3.3 // 插入图片

//链接点击锚点如图一/2.3/2.3.3

4.隐藏文字写法： 这里看不见

文章内锚点插入“

标题#

1
这里是一些文本。
2

3
<a id="section1"></a>
4
这里是另一个标题，你想跳转到的部分。
5

6
[跳转到第二节](#section1)```

左对齐文本	居中文本	右对齐文本
这是	居中	文本
一些	示例	数据

7.部分图例

✅ 成功

配置已保存并生效。系统将在下次重启时应用新设置。警告信息：

⚠️ 警告

此操作不可逆转，请确保已备份重要数据。错误信息：

❌ 错误

连接数据库失败，请检查网络连接或联系系统管理员。信息提示：

ℹ️ 提示

首次使用需要进行账户验证，验证邮件已发送到您的邮箱。

为世界所有美好而战

错过了落日余晖，还可以期待满天繁星。#

一、文件夹型结构#

二、文件结构#

三、常见markdown语法#

标题#

🌈友情文章#