k4zuki/pandocker-alpine

pandocker-alpine

镜像概述

pandocker-alpine是一个基于Alpine Linux的轻量级Docker镜像，集成了pandoc文档转换工具与LaTeX排版系统（含xelatex引擎），并包含常用过滤器，旨在提供高效的文档格式转换与专业排版能力。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低，适合轻量化部署
• 完整工具链：集成pandoc（支持多格式文档转换）、LaTeX环境（含xelatex引擎）及相关依赖
• 排版支持：通过xelatex引擎支持复杂排版需求，包括中文、日文等多语言文本处理
• 过滤器集成：预配置常用pandoc过滤器，支持代码块高亮、图表生成等扩展功能
• 多格式转换：支持Markdown、HTML、LaTeX、PDF、DOCX、EPUB等格式间的双向转换

使用场景与适用范围

• 学术文档处理：将Markdown格式论文转换为符合期刊要求的PDF（支持公式、图表排版）
• 技术文档生成：将API文档、README等转换为HTML、PDF或电子书格式
• 自动化工作流：集成至CI/CD流程，实现文档的自动生成、转换与发布
• 本地开发环境：为开发者提供无需本地安装复杂依赖的文档处理环境

使用方法与配置说明

基本使用方式

通过挂载本地目录至容器/data路径，执行pandoc命令进行文档转换：

bash
docker run --rm -v $(pwd):/data pandocker-alpine pandoc [输入文件] -o [输出文件] [参数]

常用命令示例

Markdown转PDF（含中文支持）

bash
docker run --rm -v $(pwd):/data pandocker-alpine pandoc input.md -o output.pdf \
  --pdf-engine=xelatex \
  -V mainfont="SimSun" \
  -V sansfont="SimHei" \
  -V monofont="Courier New"

Markdown转HTML

bash
docker run --rm -v $(pwd):/data pandocker-alpine pandoc input.md -o output.html --standalone

使用过滤器处理代码块

bash
docker run --rm -v $(pwd):/data pandocker-alpine pandoc input.md -o output.pdf \
  --pdf-engine=xelatex \
  --filter pandoc-codeblock-filter

高级配置

• 自定义字体：通过-V参数指定字体，确保中文等非英文字符正常显示
• 扩展依赖：如需添加额外LaTeX包或过滤器，可通过docker exec进入容器安装，或基于此镜像构建自定义Dockerfile
• 批量转换：结合shell脚本实现多文件批量处理，示例：

  bash
  #!/bin/bash
  for file in *.md; do
    docker run --rm -v $(pwd):/data pandocker-alpine pandoc "$file" -o "${file%.md}.pdf" --pdf-engine=xelatex
  done
  

注意事项

• 挂载目录时确保本地文件路径正确，容器内通过/data访问宿主文件
• 复杂排版需求可能需要额外LaTeX宏包，可通过-V参数或自定义镜像解决
• 转换大型文档时建议增加容器内存限制（通过--memory参数）