麒麟os安装pandoc有三种方法:apt仓库安装(推荐,执行sudo apt update && sudo apt install pandoc pandoc-data)、snap安装(需启用snapd并sudo snap install pandoc)、手动下载.deb包安装(适用于离线环境);此外需配置tex live以支持pdf输出,并通过测试文件验证转换功能。

如果您在麒麟操作系统上需要将 Markdown、LaTeX 或其他标记格式转换为 PDF、HTML、Word 等目标格式,但系统中尚未安装 Pandoc,则需手动完成安装与基础配置。以下是适用于麒麟OS(基于 Debian/Ubuntu 的 Kylin V10 SP1 及后续版本)的多种安装方法:
一、通过APT仓库安装(推荐)
麒麟OS默认启用麒麟软件商店及官方APT源,Pandoc 已收录于 kylin-adv-updates 仓库中,此方式可确保版本兼容性与依赖自动解析。
1、打开终端,执行更新命令以同步软件包索引:
sudo apt update
2、安装 pandoc 及其依赖项:
sudo apt install pandoc pandoc-data
3、验证安装是否成功:
pandoc --version
若输出包含 pandoc 3.1.x 及以上版本号,表示安装完成。
二、使用 Snap 安装(跨版本兼容)
Snap 包格式由 Canonical 维护,提供沙箱化运行环境与自动更新机制,适用于未启用标准 APT 源或需较新 Pandoc 版本的场景。
1、确认 snapd 服务已启用:
sudo systemctl status snapd
2、如未运行,启用并启动服务:
sudo systemctl enable --now snapd
3、安装 pandoc snap 包:
sudo snap install pandoc
4、将 snap bin 目录加入 PATH(若命令不可用):
export PATH=$PATH:/snap/bin
执行后,pandoc --version 应返回 snap 提供的最新稳定版(如 3.3.x)。
三、手动下载 Debian 包安装(离线环境适用)
当目标机器无网络连接或需指定特定版本时,可从 pandoc 官方 GitHub 发布页下载 .deb 文件进行本地安装,避免依赖缺失风险。
1、在联网设备上访问 https://github.com/jgm/pandoc/releases,下载对应架构的 .deb 文件(如 pandoc-3.3.1-1-amd64.deb)
2、将文件复制至麒麟OS目标机器任意目录(如 /home/user/Downloads)
3、在终端中进入该目录,执行安装:
sudo dpkg -i pandoc-3.3.1-1-amd64.deb
4、修复可能存在的依赖问题:
sudo apt --fix-broken install
安装完成后,pandoc -v 将显示所安装的确切版本与构建信息。
四、配置 LaTeX 引擎支持 PDF 输出
Pandoc 默认支持 HTML、Markdown 等轻量格式转换,但生成 PDF 需依赖外部排版引擎。麒麟OS 默认未预装 LaTeX 套件,需额外部署。
1、安装完整 TeX Live 套件(含 xelatex):
sudo apt install texlive-full
2、若仅需最小 PDF 支持,可安装精简组合:
sudo apt install texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra
3、验证引擎可用性:
xelatex --version
输出中应包含 XeTeX 3.14159265 或更高版本标识,表明 PDF 导出链已就绪。
五、验证基础转换功能
安装完成后需测试核心转换能力,确保 Pandoc 与系统工具链协同工作正常。
1、创建测试 Markdown 文件 test.md,内容为:
# Hello Kylin
This is a **test**.
2、执行 HTML 转换:
pandoc test.md -o test.html
3、执行 PDF 转换(需已配置 LaTeX):
pandoc test.md -o test.pdf
若 test.html 可被浏览器正常打开,且 test.pdf 生成无报错,说明 Pandoc 主体功能与 PDF 后端均已激活。










