开始使用：怎么写一篇文档

一、文档放在哪

所有文档都是 source/_posts/ 下的一个 .md 文件，一个文件 = 一篇文档。
写完执行一条命令重建，页面就有了。

1
2
3
4

/home/lxc/data/blog/source/_posts/
├── 怎么写文档.md          ← 中文文件名可以直接用
├── docker-常用命令.md
└── nginx-源码编译.md

二、开头必须有这一段（front-matter）

1
2
3
4
5
6
7
8

---
title: 这篇文档的标题
date: 2026-10-26 12:00:00
categories: 运维
tags:
  - docker
  - nginx
---

• date 决定排序，写错顺序就乱
• categories 会出现在「分类」页
• tags 会出现在「标签」页

三、三种写法（挑顺手的）

1. Tabby 直接拖：点窗口右上角 SFTP，把 .md 拖进 source/_posts/，回终端敲 blog build
2. 命令行新建：blog new "Docker 常用命令" 会自动生成带 front-matter 的空文档，然后 vim 编辑
3. 本地写完上传：本机 VSCode / Obsidian 写好，scp 上来，再 blog build

四、常用命令

五、语法速查

正文就是标准 Markdown：

• 标题 ## ###
• 代码块用三个反引号加语言名（```bash）
• 表格、引用、列表都支持
• 图片放 source/img/，正文写 ![说明](/img/文件名.png)

写完 一定要 blog build，否则线上还是旧内容。