如何写一篇文章
发布新文章只需要三步。
1. 新建文件
在 content/posts/ 目录下新建一个 .md 文件,建议文件名带上日期前缀,例如:
content/posts/2026-10-21-my-first-post.md
2. 填写头部信息(frontmatter)
文件最顶部用 --- 包裹一段 YAML 信息:
---
title: "文章标题"
date: 2026-10-21
tags: [标签1, 标签2]
summary: "一句话摘要,会显示在首页和 RSS 里"
---
3. 写正文并生成
头部下面就是正文,支持标准 Markdown 语法。写完后在项目根目录运行:
python build.py
生成的整站会出现在 public/ 目录,把它上传到服务器即可。
支持哪些语法
- 标题、列表、引用、分割线
- 加粗、斜体、
行内代码 - 代码块(带等宽字体与边框)
- 链接与图片
就这么简单,去写你的第一篇吧。