's'

public/markdown/README.md

@@ -0,0 +1,36 @@
+# Markdown 内容目录
+
+## 目录结构
+
+```
+public/markdown/
+├── course/           # 课程配套文章
+│   ├── 1/            # 课程 ID
+│   │   ├── 1.md      # 章节 ID
+│   │   ├── 2.md
+│   │   └── 3.md
+│   └── 2/
+│       ├── 1.md
+│       └── 2.md
+└── ebook/            # 电子书章节
+    ├── 1/
+    │   ├── 1.md
+    │   ├── 2.md
+    │   └── 3.md
+    └── 2/
+        ├── 1.md
+        └── 2.md
+```
+
+## 引用方式
+
+**数据库 / mock 中的 `article_markdown` 或 `content` 字段：**
+
+| 格式 | 说明 |
+|------|------|
+| `@file:course/1/1` | 加载 `/markdown/course/1/1.md` |
+| `@file:ebook/2/3` | 加载 `/markdown/ebook/2/3.md` |
+| `# 标题\n\n内容...` | 直接使用字符串 Markdown |
+
+- 文件路径：`@file:{type}/{id}/{chapterId}`，扩展名 `.md` 可省略
+- 字符串：非 `@file:` 开头的任意 Markdown 文本