# Markdown 预览
> 在线 Markdown / HTML 内容预览页，按参数拉取内容并渲染展示。

## 1. 页面信息

- 网页地址：https://9kvr.cn/plugin/markdown
- 所属模块：插件与工具
- 页面用途：通用的富文本预览页：通过链接参数指定内容类型与名称，页面据此向后端拉取内容，并按类型用 Markdown 渲染（含代码高亮）或直接输出 HTML。适合展示协议、说明、帮助文档等长文本内容。
- 适用用户：需要查看由平台下发的 Markdown 或 HTML 内容的用户
- 访问条件：公开访问（凭链接带参数进入）

## 2. 功能说明

- 支持 html 与 markdown 两种内容类型
- Markdown 渲染并支持代码高亮
- 支持通过参数指定页面标题
- 加载失败或内容为空时展示空状态

## 3. 业务说明

### 内容来源

本页只负责渲染，实际内容由后端按内容类型与名称下发，因此同一个页面可用于展示不同的文档。

### 渲染方式

Markdown 类型会渲染标题、列表、表格、代码块等并做代码高亮；HTML 类型则直接呈现传入内容。

### 表单字段

| 字段 | 类型 | 是否必填 | 取值来源 | 默认值 | 限制与说明 | 影响费用 |
| --- | --- | --- | --- | --- | --- | --- |
| 内容类型（type） | 查询参数 | 选填 | URL 参数 | 1 | 支持 html / markdown，缺省按默认类型处理 | 未核实（视实际规则） |
| 内容名称（name） | 查询参数 | 选填 | URL 参数 |  | 用于定位要展示的内容 | 未核实（视实际规则） |
| 标题（title） | 查询参数 | 选填 | URL 参数 |  | 作为页面标题展示 | 未核实（视实际规则） |

## 4. 使用说明

1. 通过带内容类型、名称、标题参数的链接进入本页
2. 页面按名称向后端请求内容
3. 按返回的内容类型渲染 HTML 或 Markdown
4. 滚动查看正文内容

## 5. 规则与限制

- 未知内容类型会显示「不支持的内容类型」空状态
- 未带参数时使用默认内容类型与空名称发起请求

## 6. 状态与异常

- 加载中：展示加载动画
- 有内容：展示标题与渲染后的正文
- 内容为空或加载失败：展示「无法加载内容」空状态
- 未知类型：展示「不支持的内容类型」空状态
- 内容请求失败或返回异常时展示「无法加载内容」

## 7. 相关文档

- [插件服务中心](https://9kvr.cn/site/plugin/list.md)
- 上级目录索引：[/plugin](https://9kvr.cn/site/plugin/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验