让 Markdown 带你回到写作本身

Markdown 很适合个人网站。你的内容存放在普通文件里，可以用熟悉的工具编辑，还能和代码一起纳入版本管理。

本站的文章存放在 content/ 目录下。新增一篇，只需创建一个新的 .md 文件。不需要登录任何后台。

从文章信息开始

每个文件开头有一小段 YAML，包含标题、日期和分类。这通常叫做 frontmatter。

---
title: "我的第一篇文章"
description: "简要介绍这篇文章要讲什么。"
date: "2026-09-22"
category: "随笔"
tags: ["生活", "写作"]
---

文件名会成为文章网址的一部分。例如 my-first-post.md 可以在 /articles/my-first-post 访问。用小写字母和短横线命名的短文件名，更便于分享链接。

段落之间留一个空行，章节标题用两个井号。目录会根据二级和三级标题自动生成。

## 一个新的开始

一段普通的文字，可以包含 **加粗文字** 和 *斜体*。

### 简单的流程

1. 写下你想探讨的想法。
2. 整理标题和段落。
3. 在有帮助的地方加入代码、图片或引用。

受支持的代码语言会获得语法高亮和复制按钮。表格在小屏幕上可以横向滚动，过长的链接会自动换行而不会撑开页面。

对于尚未完成的文章，在 frontmatter 中加上：

draft: true

草稿不会出现在首页、搜索结果和文章路由中。等文章准备好后，移除这个标记并重新构建即可。这是一个发布筛选开关，而非隐私机制；私密草稿请保存在站点内容目录之外。

文件承载文字，网站负责排版。之后调整字号、间距或主题，不需要修改每一篇文章。

一套好用的写作工作流可以就这么小：打开文件，写上一段，保存。剩下的事交给页面。