如何写博客文章
如何在本系统上写博客文章
在本博客系统中发布文章非常简单。
步骤一:创建 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),需要简单配置才能启用。
- 访问 giscus.app
- 使用 GitHub 登录并授权到你的仓库
- 选择你的仓库(需要开启 Discussions)
- 复制生成的配置信息
- 更新
components/Giscus.tsx文件中的配置
优点:免费、无广告、基于 GitHub
要求:GitHub 账号、公开仓库
要求:GitHub 账号、公开仓库