← 返回首页

未命名文章

阅读时间 2 分钟

文章目录

这个目录用于存放所有的 Markdown 文章文件。

如何创建新文章

  1. 在这个目录下创建一个新的 .md 文件，文件名就是文章的 URL slug（例如：my-article.md 对应 /article/my-article）

  2. 在文件开头添加 frontmatter（YAML 格式）：

---
title: 文章标题
date: 2024-03-15
category: 分类名称
excerpt: 文章摘要，会显示在首页卡片上
coverImage: https://example.com/image.jpg
readTime: 8
---

这里是文章正文，使用 Markdown 格式编写...

Frontmatter 字段说明

  • title: 文章标题（必填）
  • date: 发布日期，格式：YYYY-MM-DD（必填）
  • category: 文章分类（必填）
  • excerpt: 文章摘要，显示在首页卡片上（必填）
  • coverImage: 封面图片 URL（可选）
  • readTime: 预计阅读时间（分钟），如果不填会自动计算（可选）

Markdown 支持

文章正文支持标准的 Markdown 语法：

  • 标题: # H1, ## H2, ### H3 等
  • 段落: 普通文本
  • 强调: **粗体**, *斜体*
  • 引用: > 引用内容
  • 列表: - 无序列表 或 1. 有序列表
  • 链接: [链接文本](URL)
  • 图片: ![alt文本](图片URL)

静态生成

这个博客是完全静态的：

  • 所有文章在构建时（npm run build）读取并生成静态 HTML
  • 不需要后台服务，可以直接部署到 GitHub Pages、Netlify、Vercel 等静态托管
  • 运行 npm run build 后，所有页面都是预生成的静态文件

示例

查看 featured.md 作为参考示例。