manzhushaka｜札记 https://manzhushaka.cn 把模糊的想法，做成真正可用的东西。 zh-CN 博客上线：一篇 Markdown 如何变成页面 https://manzhushaka.cn/blog/hello-blog https://manzhushaka.cn/blog/hello-blog Fri, 31 Jul 2026 16:00:00 GMT 这个站从今天开始有了真正的博客：文章以 Markdown 文件存在仓库里，提交、打 tag、自动发布。这篇文章说明它怎么用，以及我为什么没有做管理后台。 这个站之前有一个"最近札记"板块，但那些条目只是目录，点不开，也没有正文。从今天起它是真的了：每一篇文章就是一个 Markdown 文件，放进仓库就会被构建成独立页面。

一篇文章长什么样

每篇文章是 content/blog/ 下的一个 .md 文件，文件名的前段是文章地址，例如 hello-blog.md 对应 /blog/hello-blog。文件开头是一段 frontmatter，用来描述这篇文章：

---
title: "文章标题"
date: 2026-08-01
category: 建站手记
tags: [博客, Markdown]
summary: "列表页和首页展示的摘要。"
draft: false
---

然后是正文，用普通的 Markdown 书写。标题、列表、代码块、引用、图片都支持。

草稿怎么处理

把 draft 改成 true，这篇文章就会留在仓库里，但不会出现在博客列表和首页上。写完再改成 false，下次发版自然上线。Git 本身就是草稿箱：没提交的是草稿，提交了不打 tag 的也不会上线。

发布流程

和这个站其他内容一样，文章走同一条发版链路：

  1. 写一个 .md 文件，本地预览确认排版
  2. 提交代码，打一个版本 tag
  3. GitHub Actions 自动构建、打包、部署，nginx 切换版本后上线

为什么没有管理后台

低频个人写作，不需要一个登录页、数据库和接口来支撑。管理后台意味着多一整套鉴权、数据存储和运维面，而公网暴露面越小越好。等写作频率高到"打开编辑器"本身成为负担，或者有合作作者时，再考虑也不迟。

现在，写就是了。

]]> 建站手记