返回首页

如何写博客文章

如何在本系统上写博客文章

在本博客系统中发布文章非常简单。

步骤一:创建 Markdown 文件

在项目的 posts/ 目录下创建一个 .md 文件,文件名会成为 URL 路径。

例如:my-first-post.md → 访问地址为 /posts/my-first-post

步骤二:添加 Frontmatter

每篇文章开头需要包含元信息:

---
title: 文章标题
date: 2025-01-21
excerpt: 文章摘要
tags:
  - 标签1
---

步骤三:编写正文

使用标准 Markdown 语法编写内容,支持:

  • 粗体斜体
  • 代码块和行内代码
  • 表格、列表、引用
  • 图片和链接

步骤四:发布

保存文件后,推送到 GitHub:

git add .
git commit -m "add: 新文章"
git push

Vercel 会自动部署,新文章即刻上线!

💬 评论区

💡 如何启用评论

当前评论系统使用 Giscus(基于 GitHub Discussions),需要简单配置才能启用。

  1. 访问 giscus.app
  2. 使用 GitHub 登录并授权到你的仓库
  3. 选择你的仓库(需要开启 Discussions)
  4. 复制生成的配置信息
  5. 更新 components/Giscus.tsx 文件中的配置
优点:免费、无广告、基于 GitHub
要求:GitHub 账号、公开仓库

感谢阅读!如有任何问题或建议,欢迎交流。