Skip to content

Commit 8569d0d

Browse files
committed
修改
1 parent 6365ee5 commit 8569d0d

File tree

1 file changed

+79
-52
lines changed

1 file changed

+79
-52
lines changed

_posts/2025-01-01-TEST.md

Lines changed: 79 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -6,39 +6,49 @@ pin: true
66
math: true
77
mermaid: true
88
---
9-
## 文件创建与放置
10-
首先创建一个格式为 **年-月-日-标题.后缀** 的文件并将其放在根目录的 **_posts** \
11-
注意:**后缀**必须是**md**\
12-
如果您想节省创建文件的时间,可以使用插件: [Jekyll-Compose](https://github.com/jekyll/jekyll-compose)
139

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 配置,格式如下:
1624

1725
```yaml
1826
---
1927
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
3644
---
3745
```
3846

39-
### 列表 | Lists
47+
---
4048

41-
#### 代码块
49+
# 📚 列表 | Lists
50+
51+
## ✅ Markdown 代码块
4252

4353
```md
4454
### 有序
@@ -69,7 +79,7 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
6979
: 地球的天然卫星,通过太阳的反射光可见
7080
```
7181

72-
## 实际显示:
82+
## 💡 实际效果
7383

7484
### 有序
7585

@@ -79,16 +89,19 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
7989

8090
### 无序
8191

82-
-
83-
-
84-
-
92+
*
93+
94+
*
95+
96+
*
8597

8698
### 待办事项列表
8799

88-
- [ ] 工作
89-
- [x] 步骤 1
90-
- [x] 步骤 2
91-
- [ ] 步骤 3
100+
* [ ] 工作
101+
102+
* [x] 步骤 1
103+
* [x] 步骤 2
104+
* [ ] 步骤 3
92105

93106
### 描述列表
94107

@@ -98,47 +111,61 @@ image: # ❌【推荐】用于社交平台预览图,支持下列
98111
月亮
99112
: 地球的天然卫星,通过太阳的反射光可见
100113

101-
# 引用 | Block Quote
102-
## 代码块
114+
---
115+
116+
# 💬 引用 | Block Quote
117+
118+
## ✅ Markdown 写法
103119

104120
```md
105121
> 这是一个块引用
106122
```
107123

108-
## 实际显示:
109-
> 此行显示块引用
124+
## 💡 实际效果
110125

111-
# 提示 | Prompts
112-
## 代码块
126+
> 这是一个块引用
127+
128+
---
129+
130+
# 🚨 提示块 | Prompts
131+
132+
## ✅ Markdown 写法
113133

114134
```md
115-
> 这是一个`tip`类型提醒
135+
> 这是一个 `tip` 类型提醒
116136
{: .prompt-tip }
117137

118-
> 这是一个`info`类型提醒
138+
> 这是一个 `info` 类型提醒
119139
{: .prompt-info }
120140

121-
> 这是一个`warning`类型提醒
141+
> 这是一个 `warning` 类型提醒
122142
{: .prompt-warning }
123143

124-
> 这是一个`danger`类型提醒
144+
> 这是一个 `danger` 类型提醒
125145
{: .prompt-danger }
126146
```
127147

128-
## 实际显示:
129-
> 这是一个`tip`类型提醒
130-
{: .prompt-tip }
148+
## 💡 实际效果
131149

132-
> 这是一个`info`类型提醒
133-
{: .prompt-info }
150+
> 这是一个 `tip` 类型提醒
151+
> {: .prompt-tip }
134152
135-
> 这是一个`warning`类型提醒
136-
{: .prompt-warning }
153+
> 这是一个 `info` 类型提醒
154+
> {: .prompt-info }
137155
138-
> 这是一个`danger`类型提醒
139-
{: .prompt-danger }
156+
> 这是一个 `warning` 类型提醒
157+
> {: .prompt-warning }
158+
159+
> 这是一个 `danger` 类型提醒
160+
> {: .prompt-danger }
161+
162+
---
140163

141164
# 🏁 最后
142165

143166
感谢你看到这里 🙏
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

Comments
 (0)