博客与内容
使用 MDX 添加和管理博客文章
博客与内容
LaunchSaaS 包含一个由 MDX 驱动的完整博客系统,允许你使用 Markdown 编写文章并嵌入 React 组件。
博客结构
博客内容以 MDX 文件形式存储在 content/blog/ 中:
content/
└── blog/
├── my-first-post.mdx
├── another-post.mdx
└── ...创建博客文章
在 content/blog/ 中创建新文件:
---
title: 你的文章标题
description: 用于 SEO 的简短描述
date: 2025-01-15
author:
name: 张三
avatar: /avatar.png
url: https://example.com
category:
id: tutorial
title: 教程
cover: /blog/post-image.jpg
published: true
---
# 你的文章标题
这是你的博客文章内容。你可以使用常规的 Markdown 语法。
## 标题
**粗体文本**、_斜体文本_ 和 `内联代码`。
- 项目符号
- 另一个要点
1. 编号列表
2. 第二项
> 用于重要信息的引用
[链接到其他页面](/docs)Front Matter 字段
| 字段 | 必需 | 描述 |
|---|---|---|
title | 是 | 文章标题 |
description | 是 | 简短描述(SEO) |
date | 是 | 发布日期(YYYY-MM-DD) |
author | 否 | 作者信息对象 |
category | 否 | 分类对象(id 和 title) |
cover | 否 | 特色图片路径 |
published | 否 | 设置为 false 以隐藏文章 |
文档
文档页面以相同的 MDX 格式存储在 content/docs/ 中。
侧边栏顺序
在 content/docs/meta.json 中配置文档侧边栏:
{
"pages": [
"index",
"getting-started",
"---章节标题---",
"page-name",
"another-page"
]
}使用 ---标题--- 格式创建章节分隔符。
更新日志
更新日志条目以基于日期的文件名存储在 content/changelog/ 中:
content/
└── changelog/
├── 2025-01-15.mdx
├── 2025-01-01.mdx
└── ...