一、本地图片

把图片文件放进 assets/images/ 文件夹，然后在正文里用下面的语法引用：

![写作到发布流程](/assets/images/demo-illustration.svg)

效果如下：

二、网络图片

不保存文件，直接引用图片链接（比如图床、云存储或任意网址）：

![网络示例图片](https://picsum.photos/seed/shi-guang/800/450)

效果如下（若网络图片加载失败，会显示说明文字）：

三、封面图

在文章开头的 frontmatter 里写一行 cover:，就会自动显示在首页缩略图、文章顶部横幅和分享卡片上：

---
title: 我的文章
cover: /assets/images/covers/cover-demo.svg
---

本文顶部那张横幅就是封面图的效果。

四、其他常用语法一览

加粗文字、斜体文字、行内代码。

• 无序列表项
• 另一个列表项

1. 有序列表项
2. 第二个有序列表项

这是一段引用文字，用来强调重点。

def hello():
    print("代码块会自动高亮")

总结

• 发表：把 .md 文件放进 content/posts/，提交推送即可自动上线
• 本地图片：放进 assets/images/，用 /assets/images/文件名 引用
• 网络图片：直接用完整链接
• 封面图：frontmatter 里的 cover: 字段

快去试试写你的第一篇正式文章吧！

一篇文章长什么样

在文件开头用 --- 写基本信息（这叫 frontmatter）：

---
title: 我的第一篇文章
date: 2026-08-24
tags: [教程, 随笔]
summary: 一句话摘要，会显示在首页。
---

这里是正文，用 Markdown 写就行。

发布流程

1. 新建文件：content/posts/my-post.md
2. 写正文，支持标题、列表、代码、表格、引用等语法
3. 在项目根目录运行：

python build.py

4. 本地预览：

python build.py --serve
# 然后打开 http://127.0.0.1:8000/

小技巧

• date 支持 2026-08-24 或带时间的格式
• tags 用逗号或空格分隔，会自动生成标签页
• 想写草稿时加一行 draft: true，构建时会自动跳过
• 正文里写 [TOC] 可以自动生成文章目录

一切从第一篇开始。

标题

用 # 的个数表示级别，最多 6 级：

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

文字样式

列表

- 无序列表项
- 无序列表项

1. 有序列表项
2. 有序列表项

链接与图片

[链接文字](https://example.com)

![图片说明](/assets/images/你的图片.jpg)

引用

> 这是一段引用文字。

代码块

用三个反引号包裹，后面可以写语言名（会自动高亮）：

```python
print("你好")
```

表格

| 表头一 | 表头二 |
| --- | --- |
| 内容 | 内容 |

分割线

---

其他小技巧

• 文章里写 [TOC] 可以自动生成目录
• 想写草稿时，在文章开头加 draft: true，构建时自动跳过
• 文章的分类、标签、封面图写在文件开头的 --- 里（frontmatter）：

---
title: 文章标题
category: 教程
tags: [Markdown, 教程]
cover: /assets/images/covers/xxx.jpg
summary: 一句话摘要
---

记不住怎么办？

• 随时打开本文查询
• 仓库里的 content/文章模板.md 也是现成范例
• 问 AI（比如我）："这句话用 Markdown 怎么写？"

写多了自然就熟了，祝写作愉快！

我为什么要建这个博客

记录是思考的延伸。很多想法转瞬即逝，写下来才能沉淀。这个博客会用来记录：

• 学习笔记与踩坑记录
• 读书与观影感受
• 生活随笔与阶段性总结

写作不是把想法整理好再写出来，而是在写的过程中想清楚。—— 常见说法

这里有什么

下面这段是引用：

坚持写作，哪怕每周一篇。

再来看一段代码：

def hello(name):
    return f"你好，{name}！"

print(hello("读者"))

关于格式

我支持标准的 Markdown 语法，比如加粗、斜体、行内代码、链接、列表和表格：

今天就到这里，期待与你常常见面。