动态Markdown API测试
2025/8/13大约 2 分钟
动态Markdown组件测试
这个页面用于测试动态Markdown组件的两种使用方式:
- URL模式:通过URL获取Markdown文件
- 内容模式:直接传入Markdown内容字符串
URL模式示例
下面展示的是通过URL获取Markdown文件的方式:
内容模式示例
下面展示的是直接传入Markdown内容的方式:
技术说明
双模式设计
动态Markdown组件支持两种使用模式:
1. URL模式
通过URL获取Markdown文件:
<DynamicMarkdown
url="/path/to/file.md"
:show-frontmatter="true"
:retry-count="3"
/>
2. 内容模式
直接传入Markdown内容字符串:
<DynamicMarkdown
:markdown-content="markdownString"
:show-frontmatter="true"
/>
Props说明
url
: Markdown文件的URL(可选)markdown-content
: Markdown内容字符串(可选)show-frontmatter
: 是否显示frontmatter信息retry-count
: 自动重试次数(仅URL模式)data
: 传递给Vue组件的数据
使用场景
URL模式适用于:
- 静态Markdown文件
- 需要缓存的内容
- 文件系统管理的文档
内容模式适用于:
- 动态生成的内容
- 来自API的内容
- 需要实时更新的内容
- 无头CMS场景
优势
- 灵活性: 支持两种内容来源
- 兼容性: 保持向后兼容
- 性能: URL模式支持缓存,内容模式无需网络请求
- 错误处理: URL模式支持自动重试
- Vue集成: 完整的Vue组件支持