怎么写一个文章

📝 文件创建与放置

首先，在 _posts/ 目录中创建一个格式为：年-月-日-标题.md的 Markdown 文件 例如：2025-01-01-my-first-post.md

⚠️ 文件后缀必须为 .md，否则无法被识别为文章！

如果你想节省手动创建的时间，可以使用插件：Jekyll-Compose

---

🔖 前言 | Front Matter

每篇文章开头都应该有一段 Front Matter 配置，格式如下：

---
title:              # ✅【必填】文章标题，会显示在网页标题和文章头部
description:        # ❌【推荐】页面描述，用于搜索引擎摘要（SEO）
author:             # ❌【可选】作者名，默认读取 _config.yml 中的 social.name
date:               # ✅【必填】发布日期，格式为 YYYY-MM-DD HH:MM:SS +时区
categories:         # ✅【必填】分类名，至少一个,最多两个
tags:               # ❌【推荐】标签，支持多个关键词
toc:                # ❌ 是否启用目录，true/false，默认 true
pin:                # ❌ 是否置顶，true 表示置顶
math:               # ❌ 是否启用 KaTeX 数学公式，true 启用
mermaid:            # ❌ 是否启用 Mermaid 流程图，true 启用
comments:           # ❌ 是否启用评论，默认根据全局配置
render_with_liquid: # ❌ 是否使用 Liquid 模板渲染，默认 true
media_subpath:      # ❌ 媒体资源子路径，例：2025/my-images
image:              # ❌ 用于社交媒体分享图，可细化：
  path:             # 图片路径
  lqip:             # 低质量占位图（懒加载用）
  alt:              # 图片描述文字（无障碍和 SEO）
---

---

📚 列表 | Lists

✅ Markdown 代码块

#### 有序

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

#### 无序

- 章
  - 节
    - 段

#### 待办事项列表

- [ ] 工作
  - [x] 步骤 1
  - [x] 步骤 2
  - [ ] 步骤 3

#### 描述列表

太阳
: 地球绕其运行的恒星

月亮
: 地球的天然卫星，通过太阳的反射光可见

💡 实际效果

有序

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

无序

• 章

  • 节

    • 段

待办事项列表

• 工作

  • 步骤 1
  • 步骤 2
  • 步骤 3

描述列表

太阳

地球绕其运行的恒星

月亮

地球的天然卫星，通过太阳的反射光可见

---

💬 引用 | Block Quote

✅ Markdown 写法

> 这是一个块引用

💡 实际效果

这是一个块引用

---

🚨 提示块 | Prompts

✅ Markdown 写法

> 这是一个 `tip` 类型提醒
{: .prompt-tip }

> 这是一个 `info` 类型提醒
{: .prompt-info }

> 这是一个 `warning` 类型提醒
{: .prompt-warning }

> 这是一个 `danger` 类型提醒
{: .prompt-danger }

💡 实际效果

这是一个 tip 类型提醒

这是一个 info 类型提醒

这是一个 warning 类型提醒

这是一个 danger 类型提醒

---

🏁 最后

感谢你看到这里 🙏 如果你喜欢我的内容，可以订阅我的 RSS，或者点个 ⭐ star 支持我！

---

微软翻译