调用本地 pandoc 命令行工具实现 Markdown 与 PDF、HTML、DOCX 等格式互转，支持模板、样式与元数据定制。
说明：
## 核心用法
`local-pandoc` 技能通过调用系统本地安装的 `pandoc` 命令行工具，实现 Markdown 文件向 PDF、HTML、DOCX 等多种格式的转换。基础语法为 `pandoc [options] [input-file]`，支持通过 `-f`/`-t` 显式指定输入输出格式，使用 `-s`/`–standalone` 生成完整独立文档。PDF 输出依赖本地 LaTeX 引擎（如 xelatex），可通过 `-V` 参数控制页面边距、字号等排版变量。
### 显著优点
1. **格式覆盖广**：原生支持 Markdown、HTML、DOCX、LaTeX、EPUB 等数十种标记格式互转
2. **排版可控性强**：支持自定义模板（`–template`）、CSS 样式（`–css`）、参考文档（`–reference-doc`）及详细元数据注入
3. **文档结构化功能**：自动生成目录（`–toc`）、调整标题层级（`–shift-heading-level-by`）、读取远程 URL 内容等
4. **本地执行**：转换过程完全离线，无需上传敏感文档至第三方服务
### 潜在缺点与局限性
– **环境依赖重**：PDF 输出必须预装 TeX Live/MiKTeX 等 LaTeX 发行版，安装体积通常超过 1GB
– **模板调试成本**：自定义 LaTeX/PDF 模板需掌握一定排版知识，错误配置易导致生成失败
– **中文支持门槛**：默认 LaTeX 引擎对中文支持有限，需额外配置 CJK 宏包或改用 xelatex/lualatex
– **无实时预览**：命令行工具缺乏可视化反馈，需反复执行查看效果
### 适合人群
技术写作者、学术研究人员、开源文档维护者，以及需要批量生成标准化 PDF 报告、电子书或 Word 文档的开发者。特别适合对文档排版有定制需求、且愿意维护本地工具链的用户。
### 常规风险
– **依赖缺失风险**：若未正确安装 LaTeX 或指定引擎，PDF 生成命令将报错退出
– **路径遍历风险**：技能若未对输入文件名做校验，可能受 `–template` 或 `–reference-doc` 参数影响读取任意系统文件（需结合具体实现判断）
– **命令注入风险**：用户输入直接拼接至 shell 命令时，存在特殊字符逃逸可能
– **资源消耗**：大型文档转换可能触发 CPU/内存高占用，尤其是复杂 LaTeX 编译场景
会员专属
