@@ -6,39 +6,49 @@ pin: true
6
6
math : true
7
7
mermaid : true
8
8
---
9
- ## 文件创建与放置
10
- 首先创建一个格式为 ** 年-月-日-标题.后缀** 的文件并将其放在根目录的 ** _ posts** \
11
- 注意:** 后缀** 必须是** md** \
12
- 如果您想节省创建文件的时间,可以使用插件: [ Jekyll-Compose] ( https://github.com/jekyll/jekyll-compose )
13
9
14
- ## 前言 | Front Matter
15
- 您可以在文件的顶部填写如下 ** Front Matter**
10
+ # 📝 文件创建与放置
11
+
12
+ 首先,在 ` _posts/ ` 目录中创建一个格式为:` 年-月-日-标题.md ` 的 Markdown 文件\
13
+ 例如:` 2025-01-01-my-first-post.md `
14
+
15
+ > ⚠️ 文件后缀必须为 ` .md ` ,否则无法被识别为文章!
16
+
17
+ 如果你想节省手动创建的时间,可以使用插件:[ Jekyll-Compose] ( https://github.com/jekyll/jekyll-compose ) 。
18
+
19
+ ---
20
+
21
+ # 🔖 前言 | Front Matter
22
+
23
+ 每篇文章开头都应该有一段 Front Matter 配置,格式如下:
16
24
17
25
``` yaml
18
26
---
19
27
title : # ✅【必填】文章标题,会显示在网页标题和文章头部
20
- description : # ✅【推荐】页面的描述,用于 SEO 摘要(搜索引擎抓取摘要用 )
21
- author : # ❌【可选】文章作者,不写则默认用 _config.yml 的 social.name
22
- date : # ✅【必填】发布日期,如 2025-07-17,会用来排序文章时间线
23
- categories : # ❌【推荐】文章所属分类 ,支持单个或列表,自动生成目录页
24
- tags : # ❌【推荐】标签,用于文章检索和关联阅读,支持多个
25
- toc : # ❌【推荐】是否显示目录(Table of Contents) ,true / false,默认 true
26
- pin : # ❌【可选】是否置顶文章 ,true 表示置顶(Chirpy 支持置顶)
27
- math : # ❌【可选】 是否启用 KaTeX 数学公式支持 ,true 启用
28
- mermaid : # ❌【可选】 是否启用 Mermaid 流程图支持 ,true 启用
29
- comments : # ❌【推荐】是否启用评论功能,true/false,默认跟随 _config.yml
30
- render_with_liquid : # ❌【进阶】 是否使用 Liquid 模板引擎渲染文章 ,默认 true
31
- media_subpath : # ❌【进阶】该文章的资源(图片等)所在子路径,如 ` 2025/example`
32
- image : # ❌【推荐】用于社交平台预览图,支持下列子字段
33
- path : # 图片路径,支持相对路径或外链
34
- lqip : # 用于懒加载的低质量预览图路径(Low Quality Image Placeholder )
35
- alt : # 图片的替代文本,用于 SEO 和无障碍阅读
28
+ description : # ✅【推荐】页面描述,用于搜索引擎摘要(SEO )
29
+ author : # ❌【可选】作者名,默认读取 _config.yml 中的 social.name
30
+ date : # ✅【必填】发布日期,格式为 YYYY-MM-DD HH:MM:SS +时区
31
+ categories : # ❌【推荐】分类名 ,支持单个或列表
32
+ tags : # ❌【推荐】标签,支持多个关键词
33
+ toc : # ❌ 是否启用目录 ,true/ false,默认 true
34
+ pin : # ❌ 是否置顶 ,true 表示置顶
35
+ math : # ❌ 是否启用 KaTeX 数学公式 ,true 启用
36
+ mermaid : # ❌ 是否启用 Mermaid 流程图 ,true 启用
37
+ comments : # ❌ 是否启用评论,默认根据全局配置
38
+ render_with_liquid : # ❌ 是否使用 Liquid 模板渲染 ,默认 true
39
+ media_subpath : # ❌ 媒体资源子路径,例: 2025/my-images
40
+ image : # ❌ 用于社交媒体分享图,可细化:
41
+ path : # 图片路径
42
+ lqip : # 低质量占位图(懒加载用 )
43
+ alt : # 图片描述文字(无障碍和 SEO)
36
44
---
37
45
```
38
46
39
- ### 列表 | Lists
47
+ ---
40
48
41
- #### 代码块
49
+ # 📚 列表 | Lists
50
+
51
+ ## ✅ Markdown 代码块
42
52
43
53
``` md
44
54
### 有序
@@ -69,7 +79,7 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
69
79
: 地球的天然卫星,通过太阳的反射光可见
70
80
```
71
81
72
- ## 实际显示:
82
+ ## 💡 实际效果
73
83
74
84
### 有序
75
85
@@ -79,16 +89,19 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
79
89
80
90
### 无序
81
91
82
- - 章
83
- - 节
84
- - 段
92
+ * 章
93
+
94
+ * 节
95
+
96
+ * 段
85
97
86
98
### 待办事项列表
87
99
88
- - [ ] 工作
89
- - [x] 步骤 1
90
- - [x] 步骤 2
91
- - [ ] 步骤 3
100
+ * [ ] 工作
101
+
102
+ * [x] 步骤 1
103
+ * [x] 步骤 2
104
+ * [ ] 步骤 3
92
105
93
106
### 描述列表
94
107
@@ -98,47 +111,61 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
98
111
月亮
99
112
: 地球的天然卫星,通过太阳的反射光可见
100
113
101
- # 引用 | Block Quote
102
- ## 代码块
114
+ ---
115
+
116
+ # 💬 引用 | Block Quote
117
+
118
+ ## ✅ Markdown 写法
103
119
104
120
``` md
105
121
> 这是一个块引用
106
122
```
107
123
108
- ## 实际显示:
109
- > 此行显示块引用
124
+ ## 💡 实际效果
110
125
111
- # 提示 | Prompts
112
- ## 代码块
126
+ > 这是一个块引用
127
+
128
+ ---
129
+
130
+ # 🚨 提示块 | Prompts
131
+
132
+ ## ✅ Markdown 写法
113
133
114
134
``` md
115
- > 这是一个`tip`类型提醒
135
+ > 这是一个 `tip` 类型提醒
116
136
{: .prompt-tip }
117
137
118
- > 这是一个`info`类型提醒
138
+ > 这是一个 `info` 类型提醒
119
139
{: .prompt-info }
120
140
121
- > 这是一个`warning`类型提醒
141
+ > 这是一个 `warning` 类型提醒
122
142
{: .prompt-warning }
123
143
124
- > 这是一个`danger`类型提醒
144
+ > 这是一个 `danger` 类型提醒
125
145
{: .prompt-danger }
126
146
```
127
147
128
- ## 实际显示:
129
- > 这是一个` tip ` 类型提醒
130
- {: .prompt-tip }
148
+ ## 💡 实际效果
131
149
132
- > 这是一个` info ` 类型提醒
133
- {: .prompt-info }
150
+ > 这是一个 ` tip ` 类型提醒
151
+ > {: .prompt-tip }
134
152
135
- > 这是一个` warning ` 类型提醒
136
- {: .prompt-warning }
153
+ > 这是一个 ` info ` 类型提醒
154
+ > {: .prompt-info }
137
155
138
- > 这是一个` danger ` 类型提醒
139
- {: .prompt-danger }
156
+ > 这是一个 ` warning ` 类型提醒
157
+ > {: .prompt-warning }
158
+
159
+ > 这是一个 ` danger ` 类型提醒
160
+ > {: .prompt-danger }
161
+
162
+ ---
140
163
141
164
# 🏁 最后
142
165
143
166
感谢你看到这里 🙏
144
- 如果你喜欢我的内容,可以订阅我的 [ RSS] ( https://dong-jing-yu.github.io/feed.xml ) 或点个 Star ⭐ 支持我!
167
+ 如果你喜欢我的内容,可以订阅我的 [ RSS] ( https://dong-jing-yu.github.io/feed.xml ) ,或者点个 ⭐ star 支持我!
168
+
169
+ ---
170
+
171
+ ✨ 想再扩展些什么内容吗?比如 ** 脚注** 、** 代码高亮** 、** 表格/流程图示例** ?我都可以继续补上哦!
0 commit comments