fluidtopics/markdown Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Markdown转Fluid Topics命令行工具

镜像概述和主要用途

该工具旨在收集项目中不同位置的Markdown（.md）文档，构建zip归档并上传至Fluid Topics门户，实现分散文档的集中管理与发布。

核心功能和特性

• 收集项目中所有Markdown文件（.md）
• 支持通过Markdown文件中的元数据区分"公开"与"内部"内容
• 基于Markdown文件元数据构建Fluid Topics目录（ToC）
• 简化添加Map Attachments（0.13.0及以上版本支持）

使用场景和适用范围

适用于需要将分散在项目各处的Markdown文档整合、分类并上传至Fluid Topics平台进行集中管理的场景，尤其适合技术文档团队进行文档发布与维护。

使用方法和配置说明

文档参考

关于md2ft工具的详细工作原理，可参考官方文档。

Docker部署示例

基本运行命令

bash
docker run --rm -v /path/to/your/project:/app \
  -e FLUID_TOPICS_URL="https://your-fluid-topics-portal.com" \
  -e FLUID_TOPICS_API_KEY="your-api-key" \
  fluidtopics/markdown-tool:latest

参数说明

• -v /path/to/your/project:/app: 将本地项目目录挂载到容器内，工具会扫描该目录下的所有Markdown文件
• FLUID_TOPICS_URL: Fluid Topics门户的URL地址
• FLUID_TOPICS_API_KEY: 访问Fluid Topics的API密钥（需提前申请）

配置说明

工具通过Markdown文件中的元数据（如status: public或status: internal）区分内容类型，通过toc相关元数据定义目录结构。具体元数据格式可参考Markdown元数据规范。