oehrlis/pandoc

Pandoc Docker镜像

概述

本Docker镜像用于运行通用文档转换器pandoc，支持PDF文件转换功能。镜像包含精简版texlive 2022安装，可满足简单的PDF转换需求。如需更多TexLive功能，可通过扩展此镜像添加额外包。镜像源码托管于GitHub：https://github.com/oehrlis/docker-pandoc%E3%80%82

核心功能和特性

• 集成pandoc通用文档转换器，支持多种格式间的转换
• 包含精简版texlive 2022，支持基本PDF转换
• 支持通过挂载本地目录实现文件转换
• 可扩展添加额外TexLive包以满足复杂需求
• 提供交互式shell模式，便于使用pandoc和tex工具

使用场景和适用范围

• 需要进行文档格式转换（如Markdown转PDF、HTML转Word等）的用户
• 需要使用LaTeX模板生成格式化PDF文档的场景
• 需要自定义字体（如通过XeLaTeX）进行PDF转换的场景
• 希望避免本地安装pandoc和texlive环境的开发人员

使用方法

前提条件

• 已安装Docker环境

拉取镜像

bash
docker pull oehrlis/pandoc

基本使用方式

通过挂载本地文档目录作为卷运行容器，语法如下：

bash
docker run --rm -v $PWD:/workdir:z oehrlis/pandoc <OPTIONS>

• --rm：容器退出后自动删除
• -v $PWD:/workdir:z：将当前目录挂载到容器内的/workdir目录
• <OPTIONS>：pandoc转换选项

转换示例

使用默认LaTeX模板将Markdown转换为PDF

bash
cd sample
docker run --rm -v $PWD:/workdir:z oehrlis/pandoc sample.md \
    -o sample.pdf --toc -N --listings

• --toc：生成目录
• -N：对章节编号
• --listings：启用代码列表支持

使用Trivadis LaTeX模板和XeLaTeX转换（支持自定义TTF字体）

bash
cd sample
docker run --rm -v $PWD:/workdir:z oehrlis/pandoc --pdf-engine=xelatex sample.md \
    -o sample_trivadis.pdf --template trivadis --toc -N --listings

交互式shell模式

如需在容器内交互式使用pandoc和tex工具，可启动shell：

bash
docker run -it --rm -v $PWD:/workdir:z --entrypoint sh oehrlis/pandoc

构建和扩展镜像

手动构建镜像

1. 克隆源码仓库：

bash
git clone git@github.com:oehrlis/docker-pandoc.git
cd docker-pandoc

2. 构建镜像：

bash
docker build -t oehrlis/pandoc .

添加额外TexLive包

如需添加额外TexLive包，可修改Dockerfile中的tlmgr命令，添加所需包名。

使用构建脚本

也可使用仓库中的build.sh脚本进行构建：

bash
git clone git@github.com:oehrlis/docker-pandoc.git
cd docker-pandoc
./build.sh

问题反馈

如遇到bug、功能需求或其他支持问题，请通过GitHub的issue追踪器提交：

• https://github.com/oehrlis/docker-pandoc/issues
• https://github.com/oehrlis/docker-pandoc/issues/new

参考资料

• 源码GitHub项目：https://github.com/oehrlis/docker-pandoc
• pandoc官方网站
• texlive 2022
• GitHub https://github.com/google/fonts
• GitHub https://github.com/danstoner/pandoc_samples
• GitHub https://github.com/Wandmalfarbe/pandoc-latex-template
• Google Fonts (Nunito和Nunito Sans)
• Microsoft Core Fonts for the Web和Cleartype Fonts：<[***]>