麒麟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 后端均已激活。
