exfo/exfo-md-pdf Docker 镜像 - 轩辕镜像

EXFO Markdown文档渲染镜像

镜像概述和主要用途

该Docker镜像用于将Markdown格式文件渲染为带有EXFO品牌标识的文档，支持输出HTML和PDF两种格式，适用于需要生成标准化品牌文档的场景。

核心功能和特性

• 格式转换：将Markdown文件转换为EXFO品牌风格的文档
• 多格式输出：支持同时生成HTML和PDF版本文档
• 权限控制：可配置用户权限，确保生成文件的访问权限正确
• 本地文件交互：通过数据卷挂载实现宿主机与容器间的文件传输

使用场景和适用范围

• EXFO内部技术文档的标准化输出
• 需要符合品牌规范的报告和文档生成
• Markdown格式文档的可视化转换

使用方法和配置说明

Docker运行命令示例

bash
docker run --user "$UID:$GID" -v "$PWD:/data" exfo/exfo-md-pdf:latest MyDocument.md

参数说明

• --user "$UID:$GID"：设置容器运行的用户ID和组ID，通常使用当前用户的UID和GID（通过环境变量$UID和$GID获取），用于避免生成文件的权限问题
• -v "$PWD:/data"：数据卷挂载配置，将宿主机当前工作目录（$PWD）挂载到容器内的/data目录，实现输入文件的读取和输出文件的保存
• exfo/exfo-md-pdf:latest：镜像名称及标签，latest表示使用最新版本
• MyDocument.md：需要处理的Markdown文件名，该文件需位于宿主机当前工作目录下

操作步骤

1. 确保本地已安装Docker环境
2. 将需要转换的Markdown文件（如MyDocument.md）放置在当前工作目录
3. 执行上述Docker命令
4. 转换完成后，在当前工作目录下会生成同名的HTML文件（MyDocument.html）和PDF文件（MyDocument.pdf）

输出说明

生成的文档将包含EXFO品牌标识和样式，输出文件与输入Markdown文件同名，分别以.html和.pdf为扩展名，保存在宿主机当前工作目录中。