Markdown 预览
通用富文本预览页:按链接参数指定内容类型与名称,页面据此拉取内容,Markdown 渲染(含代码高亮)或直接输出 HTML。
1. 页面信息
- 网页地址:https://9kvr.cn/plugin/markdown
- 所属模块:插件与工具
- 页面用途:通过带参数的链接进入本页。页面加载时先显示加载态,随后按参数取回内容并渲染:有标题时在卡片顶部显示文件图标与标题;内容类型为 html 时直接输出 HTML,为 markdown 时按 Markdown 规则渲染(含代码高亮、软换行转行、链接自动识别、标点排版优化);类型无法识别时展示空状态。
- 适用用户:需要查看由平台下发的 Markdown 或 HTML 内容的用户
- 访问条件:公开访问(凭链接带参数进入)
2. 功能说明
- 加载期间展示全屏加载动画,加载结束后切换为内容卡片
- 卡片标题区:文件图标 + 标题文案,标题来自链接参数,没有标题时不显示该区域
- HTML 内容类型:原样输出 HTML
- Markdown 内容类型:渲染标题、列表、表格、代码块等,并按语言做代码高亮
- Markdown 渲染选项:换行即换行、链接自动识别、智能标点排版
- 不支持的内容类型展示空状态「不支持的内容类型」
- 内容为空或加载失败展示空状态「无法加载内容」
- 页面标题取自链接参数,没有参数时使用「Markdown 预览」
3. 业务说明
界面结构
| 区块 / 控件 | 类型 | 取值来源 | 限制 / 说明 |
|---|---|---|---|
| 加载动画 | 加载态 | 页面进入时 | 内容取回前显示,取回后隐藏 |
| 卡片标题(文件图标 + 标题) | 只读标题 | 链接参数中的标题 | 未传标题时不显示标题区 |
| HTML 内容区 | 富文本渲染 | 返回内容的 html 类型数据 | 直接输出 HTML |
| Markdown 内容区 | 富文本渲染 | 返回内容的 markdown 类型数据 | 按 Markdown 规则渲染并对代码块做高亮 |
| 不支持的内容类型 | 空状态 | 返回类型无法识别时 | 内容存在但类型未知时展示 |
| 无法加载内容 | 空状态 | 请求失败或内容为空时 | 展示在卡片内,替代正文 |
内容来源
本页只负责渲染,实际内容由平台按内容类型与名称下发,因此同一个页面可用于展示不同的文档、协议与帮助说明。
渲染方式
Markdown 类型会渲染标题、列表、表格、代码块等,并按代码块声明的语言做语法高亮;HTML 类型则直接呈现传入内容。
4. 使用说明
- 通过带内容类型、名称与标题参数的链接进入本页
- 页面展示加载动画,同时按名称请求对应内容
- 内容取回后按返回的类型渲染 HTML 或 Markdown 正文
- 需要时滚动浏览正文,或点击正文中的链接跳转到相关内容
5. 规则与限制
- 未指定内容类型时按默认类型请求,返回类型无法识别时显示「不支持的内容类型」
- 未指定标题时页面标题使用「Markdown 预览」,卡片内不显示标题区
- Markdown 渲染不解析内嵌 HTML,代码高亮依赖代码块声明的语言
- 本页是只读预览页,没有编辑、保存或评论能力
6. 状态与异常
- 加载中:展示加载动画,正文区域不出现
- 有内容:展示卡片标题与渲染后的正文
- 内容为空或加载失败:展示「无法加载内容」空状态
- 未知类型:展示「不支持的内容类型」空状态
- 请求失败时记录「获取Markdown内容失败」并展示「无法加载内容」
- 返回结果异常时提示「加载失败」
7. 相关文档
目录导航
同目录文档(14)
相关主题
8. 文档信息
- 事实来源:芊云全景官网页面核验
- 文档构建时间:2026-10-21 00:05:20
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验