本地Pandoc转换技能

此技能使用pandoc命令行工具在多种标记格式之间转换文档。

基本用法

一个pandoc命令的基本结构是：

pandoc [options] [input-file]…

简单转换

要将Markdown文件转换为HTML：

pandoc -o output.html input.md

指定格式

虽然pandoc可以从文件扩展名推断格式，但您可以使用-f（源格式）和-t（目标格式）标志来明确指定。

# Convert HTML to Markdown
pandoc -f html -t markdown input.html

独立文档

要创建包含适当页眉和页脚的完整文档（例如，一个完整的HTML文件），请使用-s或--standalone旗标。

pandoc -s -o output.html input.md

进阶示例

以下示例摘自官方 Pandoc 用户指南。

PDF 输出

要创建 PDF 文件，pandoc通常使用 LaTeX 引擎。请确保已安装一个。

# Basic PDF creation
pandoc input.md -o output.pdf

# Control PDF engine and style via variables
pandoc input.md -o output.pdf --pdf-engine=xelatex -V geometry:margin=1in -V fontsize=12pt

文档结构与元数据

Pandoc 可以自动生成目录并使用文档元数据。

# Create a document with a Table of Contents (up to level 3 headings)
pandoc --toc --toc-depth=3 -o output.docx input.md

# Set metadata fields from the command line
pandoc -M title:"My Report" -M author:"Galactus" -o output.pdf input.md

模板与样式

您可以通过模板和其他选项控制最终输出的结构和样式。

# Use a custom template for HTML output
pandoc -s --template=my-template.html -o output.html input.md

# For HTML output, link to a custom CSS file
pandoc -s --css=styles.css -o output.html input.md

# For DOCX output, use a reference document for styling
pandoc --reference-doc=reference.docx -o output.docx input.md

从网络读取

Pandoc 可以直接从 URL 获取并转换内容。

pandoc -f html -t markdown https://www.fsf.org

其他实用选项

# Preserve tabs instead of converting them to spaces
pandoc --preserve-tabs ...

# Control line wrapping in the output source code
pandoc --wrap=none ...

# Shift heading levels (e.g., make all H1s into H2s, H2s into H3s)
pandoc --shift-heading-level-by=1 ...

这份增强版文档为使用pandoc提供了更坚实的基础。