marpteam/marp-cli

marpteam/marp-cli

镜像概述和主要用途

该镜像是https://github.com/marp-team/marp%EF%BC%88%E4%BD%BF%E7%94%A8https://github.com/marp-team/marp-core%EF%BC%89%E5%8F%8A%E4%BB%BB%E4%BD%95%E5%9F%BA%E4%BA%8Ehttps://github.com/marp-team/marpit%E6%A1%86%E6%9E%B6%E7%9A%84%E5%B9%BB%E7%81%AF%E7%89%87%E8%BD%AC%E6%8D%A2%E5%99%A8%E7%9A%84CLI%E6%8E%A5%E5%8F%A3%E3%80%82%E5%AE%83%E8%83%BD%E5%A4%9F%E5%B0%86Marp/Marpit Markdown文件转换为静态HTML/CSS、PDF、PPTX和图片等多种格式，适用于幻灯片的生成与转换需求。

核心功能和特性

• 支持多种输出格式：可将Markdown文件转换为HTML/CSS、PDF、PPTX及图片
• 实时监听模式：监控文件变化并自动重新转换
• 服务器模式：通过HTTP服务当前目录，便于幻灯片预览与分享
• 基于Chromium：在Docker环境中使用Chromium实现PDF和PPTX格式转换

使用场景和适用范围

适用于需要将Marp/Marpit格式的Markdown幻灯片快速转换为多种演示格式的场景，如技术演示文稿制作、学术报告生成、会议幻灯片准备等，支持本地转换与网络分享。

使用方法和配置说明

基本转换命令

转换为HTML

bash
docker run --rm -v $PWD:/home/marp/app/ -e LANG=$LANG marpteam/marp-cli slide-deck.md

转换为PDF（使用Docker中的Chromium）

bash
docker run --rm --init -v $PWD:/home/marp/app/ -e LANG=$LANG marpteam/marp-cli slide-deck.md --pdf

转换为PPTX（使用Docker中的Chromium）

bash
docker run --rm --init -v $PWD:/home/marp/app/ -e LANG=$LANG marpteam/marp-cli slide-deck.md --pptx

高级模式

监听模式

实时监控文件变化并自动重新转换：

bash
docker run --rm --init -v $PWD:/home/marp/app/ -e LANG=$LANG -p 37717:37717 marpteam/marp-cli -w slide-deck.md

服务器模式（在http://localhost:8080/提供当前目录服务）

bash
docker run --rm --init -v $PWD:/home/marp/app -e LANG=$LANG -p 8080:8080 -p 37717:37717 marpteam/marp-cli -s .

故障排除

在Linux发行版上使用Docker时，可能会遇到挂载本地目录的文件权限错误。为解决此问题，该镜像支持通过MARP_USER环境变量设置明确的UID/GID（详情参见https://github.com/marp-team/marp-cli/pull/334%EF%BC%89%E3%80%82

可在CLI命令中添加以下参数：

bash
-e MARP_USER="$(id -u):$(id -g)"

示例：

bash
docker run --rm -v $PWD:/home/marp/app/ -e LANG=$LANG -e MARP_USER="$(id -u):$(id -g)" marpteam/marp-cli slide-deck.md

Windows和macOS的Docker环境无需设置MARP_USER环境变量。

详情请参考https://github.com/marp-team/marp-cli%E3%80%82