---

title: CMS 内容发布系统使用指南

keywords: CMS, 发布工具, Markdown, 自动化

description: 本文详细介绍了如何使用命令行工具将本地 Markdown 文件批量发布到 CMS 系统，支持 YAML 头信息、多级目录自动分类及丰富的 Markdown 语法。

flag: recommend,top

categories:

• 文章资讯
• 科技资讯

---

CMS 内容发布系统使用指南

欢迎使用 YBB CMS 内容发布系统。本系统允许您使用 Markdown 编写文章，并通过简单的命令行工具将其同步到线上网站。

1. 快速开始

1.1 准备工作

确保您已经配置了 .env 文件中的 API 密钥：

[cms]
apikey = your_secret_key_here

1.2 编写文章

在 content 目录下创建一个新的 .md 文件，例如 my-first-post.md。

1.3 发布文章

在项目根目录下运行以下命令（Windows 用户可直接双击 publish.bat）：

php think publish:content --path=content

2. 文章格式规范

我们支持两种元数据格式：YAML Front Matter（推荐）和 Legacy 格式。

2.1 YAML Front Matter (推荐)

在文件顶部使用 YAML 语法定义元数据：

---
title: 我的文章标题
category: 技术分享
keywords: PHP, ThinkPHP, 教程
description: 这是文章的摘要描述，用于SEO优化。
flag: hot
---

这里是正文内容...

2.2 Legacy 格式 (旧版)

直接在文件开头使用特定关键字：

# 我的文章标题

分类: 技术分享
关键词: PHP, ThinkPHP
描述: 摘要描述
标记: hot

这里是正文内容...

3. 支持的 Markdown 语法

本系统内置了增强型的 Markdown 解析器，支持以下常用语法：

3.1 文本样式

• 加粗文本：使用 text
• 斜体文本：使用 text
• 链接：使用 text
• 图片：!alt (系统会自动提取第一张图片作为封面图)

3.2 代码块

支持多语言代码高亮：

namespace app\index\controller;

class Index
{
    public function index()
    {
        return 'Hello CMS!';
    }
}

3.3 列表与引用

> 这是一个引用块，用于强调重要信息。

无序列表：

• 简单易用
• 自动化管理
• 支持批量同步

3.4 多级标题

支持 # 到 ###### 六级标题，系统会自动解析为 HTML 的 <h1> - <h6>。

4. 高级功能

• 自动分类：系统会根据文件所在的目录结构自动创建或匹配栏目。
• 智能标签：如果未提供 keywords 或 tags，系统会自动从标题中提取关键词。
• 封面图提取：自动分析正文中的图片，将第一张图设为文章封面。
• 安全验证：所有 API 请求均通过 API Key 签名验证，确保数据安全。
• 自动清理：标题或文件名包含“测试”、“Test”等关键词的文章将被自动识别为测试数据并删除。

---

本文档由 CMS 发布系统自动生成。