为世界所有美好而战

一、文件夹型结构#

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

   • 在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"
     

3. 引用某篇文章:

   • 要在博客页面或其他页面中链接到你的文章，可以使用标准的 html中a标签的href属性:
     202x-xx-xx

     注意：确保链接的href属性指向正确的文章路径。

二、文件结构#

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

   • 在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"
     

3. 引用某篇文章:

   • 要在博客页面或其他页面中链接到你的文章，可以使用标准的 html中a标签的href属性:
     202x-xx-xx

     注意：确保链接的href属性指向正确的文章路径。

4. 文章通用开头（复制修改即可）：

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
---

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

三、常见markdown语法#

1. 双反引号 内加入代码可实现： daimagaoliang
2. 键入“（`（注意去掉中间）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.隐藏文字写法： 这里看不见