rstropek/pandoc-latex

Pandoc LaTeX with Eisvogel

概述

Pandoc官方提供了https://hub.docker.com/r/pandoc/latex Docker镜像。但在使用https://github.com/Wandmalfarbe/pandoc-latex-template%E4%BB%8EMarkdown%E7%94%9F%E6%88%90PDF%E6%97%B6%EF%BC%8C%E5%8E%9F%E9%95%9C%E5%83%8F%E5%9B%A0%E7%BC%BA%E5%B0%91%E9%83%A8%E5%88%86TeX Live包而无法正常工作。本镜像基于pandoc/latex构建，补充了必要依赖，可直接使用Eisvogel模板生成PDF。镜像已发布至Docker Hub：https://hub.docker.com/r/rstropek/pandoc-latex%E3%80%82

核心功能与特性

• 基于官方pandoc/latex镜像，确保基础功能兼容性
• 预安装Eisvogel模板所需的全部TeX Live包
• 包含sectsty等可选包，支持章节样式自定义（如章节前换行）
• 支持通过Lua过滤器实现手动分页
• 内置pandoc-citeproc，支持参考文献引用

使用场景

• 需要从Markdown快速生成格式化PDF文档（如报告、论文、手册）
• 希望使用Eisvogel模板的现代排版样式
• 需要跨平台（Linux/Windows）一致的PDF生成环境

使用方法

支持版本

已测试兼容https://github.com/Wandmalfarbe/pandoc-latex-template 1.4.0。

示例文件

examples文件夹包含示例文档（Markdown内容、YAML元数据）及生成的PDF文件，可作为使用参考。

Linux系统

在包含Markdown文件（如mydoc.md）和YAML元数据文件（如mydoc.yaml）的目录中执行以下命令：

bash
docker run --rm \
    -v `pwd`:/data \
    -w /data \
    rstropek/pandoc-latex \
    -f markdown \
    --template https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.0.0/eisvogel.tex \
    -t latex \
    -o mydoc.pdf \
    --metadata-file=mydoc.yaml \
    mydoc.md

Windows系统

在包含Markdown文件（如mydoc.md）和YAML元数据文件（如mydoc.yaml）的目录中执行以下命令：

bash
docker run --rm ^
    -v %cd%:/data ^
    -w /data ^
    rstropek/pandoc-latex ^
    -f markdown ^
    --template https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.0.0/eisvogel.tex ^
    -t latex ^
    -o mydoc.pdf ^
    --metadata-file=mydoc.yaml ^
    mydoc.md

高级配置

手动分页

1. 下载https://github.com/pandoc/lua-filters/blob/master/pagebreak/pagebreak.lua
2. 在docker run命令中添加--lua-filter pagebreak.lua参数
3. 在Markdown文件中使用\newpage插入分页：

markdown
# 第1章

此处为章节内容。

\newpage

# 第2章

此处为下一章内容。

参考文献引用

1. 选择引用样式（如IEEE）并获取CSL文件链接（如https://www.zotero.org/styles/ieee）
2. 创建 bibliography 文件（如bib.yaml）：

yaml
references:
- title: Azure官网
  container-title: 微软网站
  id: Azure-Homepage
  author: 微软
  URL: https://azure.microsoft.com
  type: webpage

3. 在Markdown中引用：相关内容参见[@Azure-Homepage]。
4. 在pandoc命令中添加引用参数：

bash
--filter pandoc-citeproc --bibliography=bib.yaml --csl=https://www.zotero.org/styles/ieee

开发指南

构建镜像

bash
# 使用有意义的标签（如基于Dockerfile中pandoc/latex的版本号）
docker build -t rstropek/pandoc-latex:latest .

测试

需安装https://github.com/bats-core/bats-core%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%EF%BC%9A

bash
bats tests