博客写入教程

📘 Markdown 写作模板（含 Front Matter 与语法指南）

---

第一部分：📄 Front Matter 配置说明

Front Matter 是 Markdown 文件顶部的元信息，用于配置文章标题、标签、分类、日期等内容。通常写在 --- 包裹的 YAML 格式中。

🧾 示例模板

---
layout: post
title: 我的第一篇博客
date: 2025-05-24 10:00:00
updated: 2025-05-24 12:00:00
comments: true
tags: [Markdown, 教程]
categories: [技术笔记]
permalink: /markdown-guide.html
excerpt: 本文介绍了 Markdown 的语法与博客头部配置。
disableNunjucks: false
lang: zh-CN
published: true
---

📋 字段说明表

字段名	说明	默认值
layout	页面布局模板（如 post、page）	config.default_layout
title	页面标题	文件名
date	建立日期	文件创建时间
updated	最近更新日期	文件更新时间
comments	是否启用评论	true
tags	标签数组，用于分类内容	空
categories	分类数组（适用于归档）	空
permalink	自定义永久链接（应以 / 或 .html 结尾）	null
excerpt	页面摘要，建议结合插件处理	空
disableNunjucks	禁用 Nunjucks 模板语法（{{ }}、{% %}）	false
lang	页面语言，覆盖默认配置	继承自 _config.yml
published	是否发布该文章	_posts 下为 true，草稿为 false

---

第二部分：📝 Markdown 语法速查手册

1️⃣ 标题

# 一级标题
## 二级标题
### 三级标题

---

2️⃣ 段落与换行

这是第一段。

这是第二段，  
这里使用两个空格加换行。

---

3️⃣ 文本格式

**加粗文本**
*斜体文本*
~~删除线文本~~
`行内代码`

---

4️⃣ 引用块

> 一级引用
>> 二级引用

---

5️⃣ 列表

• 无序列表

- 项目一
- 项目二

• 有序列表

1. 步骤一
2. 步骤二

---

6️⃣ 代码块

• 行内代码

这是 `inline code`

• 多行代码块

Python 示例

def greet():
    print("Hello Markdown!")

---

7️⃣ 表格

| 名称    | 类型   | 描述       |
|---------|--------|------------|
| title   | 字符串 | 文章标题   |
| date    | 日期   | 创建时间   |

---

8️⃣ 链接与图片

• 链接

[OpenAI 官网](https://www.openai.com)

• 图片

![替代文字](https://via.placeholder.com/150)

---

9️⃣ 分隔线

---

---

🔟 任务列表（GitHub 支持）

- [x] 学习 Markdown
- [ ] 写一篇博客

---

🧩 转义字符（防止符号被识别）

\*星号\* 不会加粗  
\`反引号\` 不会变成代码  

公式说明

$$ E = mc^2 $$ 可以实现公式的书写

E = mc²