如何写一篇文章

如何写一篇文章

发布新文章只需要三步。

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/ 目录,把它上传到服务器即可。

支持哪些语法

  • 标题、列表、引用、分割线
  • 加粗、斜体、行内代码
  • 代码块(带等宽字体与边框)
  • 链接与图片

就这么简单,去写你的第一篇吧。

← 返回首页