Question

我一直在尝试使用Pandoc将一些Markdown转换为PDF文件。这是Pandoc不会为我转换的示例：

# Header!

## Sub Header

themselves derived respectively from the Greek ἀναρχία i.e. 'anarchy'

这只是我从维基百科数据库转储顶部抓取的东西。潘多克完全不喜欢这样。这是它给我的错误信息：

pandoc: Error producing PDF from TeX source.
! Package inputenc Error: Unicode char \u8:ἀ not set up for use with LaTeX.

See the inputenc package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              

l.53 ...es derived respectively from the Greek ἀ

是否有命令开关我可以给它来解决这个问题？我尝试按照建议做这样的事情，但失败了：

iconv -t utf-8 test.md | pandoc -o test.pdf

更新在遵循以下John的建议之前，see this。

更新2 这是最终使其正常运行的命令。希望这会对某人有所帮助：

pandoc test2.md -o test2.pdf --latex-engine=xelatex --template=my.latex --variable mainfont="DejaVu Serif" --variable sansfont=Arial

这是my.latex：

的内容

\documentclass[$if(fontsize)$$fontsize$,$endif$$if(lang)$$lang$,$endif$$if(papersize)$$papersize$,$endif$]{$documentclass$}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{amssymb,amsmath}
\usepackage{ifxetex,ifluatex}
\usepackage{fixltx2e} % provides \textsubscript
% use microtype if available
\IfFileExists{microtype.sty}{\usepackage{microtype}}{}
% use upquote if available, for straight quotes in verbatim environments
\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
  \usepackage[utf]{inputenc}
  \usepackage{ucs}
$if(euro)$
  \usepackage{eurosym}
$endif$
\else % if luatex or xelatex
  \usepackage{fontspec}
  \ifxetex
    \usepackage{xltxtra,xunicode}
  \fi
  \defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
  \setromanfont{TeX Gyre Pagella}
  \newcommand{\euro}{€}
$if(mainfont)$
    \setmainfont{$mainfont$}
$endif$
$if(sansfont)$
    \setsansfont{$sansfont$}
$endif$
$if(monofont)$
    \setmonofont{$monofont$}
$endif$
$if(mathfont)$
    \setmathfont{$mathfont$}
$endif$
\fi
$if(geometry)$
\usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry}
$endif$
$if(natbib)$
\usepackage{natbib}
\bibliographystyle{plainnat}
$endif$
$if(biblatex)$
\usepackage{biblatex}
$if(biblio-files)$
\bibliography{$biblio-files$}
$endif$
$endif$
$if(listings)$
\usepackage{listings}
$endif$
$if(lhs)$
\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
$endif$
$if(highlighting-macros)$
$highlighting-macros$
$endif$
$if(verbatim-in-note)$
\usepackage{fancyvrb}
$endif$
$if(tables)$
\usepackage{longtable}
$endif$
$if(graphics)$
\usepackage{graphicx}
% We will generate all images so they have a width \maxwidth. This means
% that they will get their normal width if they fit onto the page, but
% are scaled down if they would overflow the margins.
\makeatletter
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth
\else\Gin@nat@width\fi}
\makeatother
\let\Oldincludegraphics\includegraphics
\renewcommand{\includegraphics}[1]{\Oldincludegraphics[width=\maxwidth]{#1}}
$endif$
\ifxetex
  \usepackage[setpagesize=false, % page size defined by xetex
              unicode=false, % unicode breaks when used with xetex
              xetex]{hyperref}
\else
  \usepackage[unicode=true]{hyperref}
\fi
\hypersetup{breaklinks=true,
            bookmarks=true,
            pdfauthor={$author-meta$},
            pdftitle={$title-meta$},
            colorlinks=true,
            urlcolor=$if(urlcolor)$$urlcolor$$else$blue$endif$,
            linkcolor=$if(linkcolor)$$linkcolor$$else$magenta$endif$,
            pdfborder={0 0 0}}
\urlstyle{same}  % don't use monospace font for urls
$if(links-as-notes)$
% Make links footnotes instead of hotlinks:
\renewcommand{\href}[2]{#2\footnote{\url{#1}}}
$endif$
$if(strikeout)$
\usepackage[normalem]{ulem}
% avoid problems with \sout in headers with hyperref:
\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
$endif$
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setlength{\emergencystretch}{3em}  % prevent overfull lines
$if(numbersections)$
$else$
\setcounter{secnumdepth}{0}
$endif$
$if(verbatim-in-note)$
\VerbatimFootnotes % allows verbatim text in footnotes
$endif$
$if(lang)$
\ifxetex
  \usepackage{polyglossia}
  \setmainlanguage{$mainlang$}
\else
  \usepackage[$lang$]{babel}
\fi
$endif$
$for(header-includes)$
$header-includes$
$endfor$

$if(title)$
\title{$title$}
$endif$
\author{$for(author)$$author$$sep$ \and $endfor$}
\date{$date$}

\begin{document}
$if(title)$
\maketitle
$endif$

$for(include-before)$
$include-before$

$endfor$
$if(toc)$
{
\hypersetup{linkcolor=black}
\setcounter{tocdepth}{$toc-depth$}
\tableofcontents
}
$endif$
$body$

$if(natbib)$
$if(biblio-files)$
$if(biblio-title)$
$if(book-class)$
\renewcommand\bibname{$biblio-title$}
$else$
\renewcommand\refname{$biblio-title$}
$endif$
$endif$
\bibliography{$biblio-files$}

$endif$
$endif$
$if(biblatex)$
\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$

$endif$
$for(include-after)$
$include-after$

$endfor$
\end{document}

Answer 1

使用--pdf-engine=xelatex选项。

Answer 2

默认情况下，将markdown文件转换为pdf文件时，Pandoc会使用pdflatex引擎。 pdflatex无法像xelatex那样顺畅地处理Unicode字符。您应该尝试使用xelatex。但，仅使用xelatex命令是不够的。通常情况下，您需要选择一个包含要排版的Unicode字符的字形的正确字体。

我是中国用户，所以以中文为例。如果您的test.md包含以下内容：

你好汉字

您可以使用以下命令编译此降价文件：

pandoc --pdf-engine=xelatex -V CJKmainfont="KaiTi" test.md -o test.pdf

在上面的命令中，--pdf-engine=xelatex用于选择LaTeX引擎（对于新版本的Pandoc，--latex-engine option is deprecated）。 -V CJKmainfont="KaiTi"用于选择支持中文的正确字体。 对于其他语言，您可以使用标记-C mainfont="<FONT_NAME>"。

如何查找支持您语言的字体

要查找支持您语言的字体，您需要知道language code。然后，如果您使用的是Linux系统或安装了TeX Live的Windows系统。您可以使用以下命令查找适合您语言的有效字体：

fc-list :lang=zh #find the font which support Chinese (language code is `zh`)

我的Linux系统上的输出显示在

下面

如果您选择使用，例如字体Source Han Serif CN，然后使用以下命令编译markdown文件：

 pandoc --pdf-engine=xelatex -V CJKmainfont="Source Han Serif CN" test.md -o test.pdf

Answer 3

五年后回到这篇文章，问题仍然存在。命令

pandoc -s test.md -t latex -o test.pdf

当test.md包含包含非拉丁字符，希腊文，西里尔文，CJK，希伯来文和阿拉伯文的文字时，

失败。

LaTeX是在Unicode之前设计的，它对不同字符集的支持在某些方面很强大但远非全面，因此使用XeLaTeX的建议是有效的，但需要人们仔细选择主字体，因为没有自动选择。

以下是可能出现的问题和解决方案的小分类。 所有测试均使用Pandoc 1.19 。

西里尔

通过T2A字体编码提供对LaTeX中西里尔字母的支持。

考虑一个小样本：

# Header

## Subheader

Tetris (Russian: Тетрис) quoting Wikipedia is a tile-matching puzzle 
video game

使用pandoc运行此示例将失败：

! Package inputenc Error: Unicode char Т (U+422)
(inputenc)                not set up for use with LaTeX.

See the inputenc package documentation for explanation.

由于fontenc选项是default.latex模板中的预定义变量，因此可以使用修补程序。

使用

运行此示例

pandoc -t latex -o tetris.pdf -V fontenc=T2A cyrillic.md

会产生正确的渲染

然而，这不能正确处理其他语言功能，例如连字符。更好的方法是使用Babel并让它选择正确的字体编码。

pandoc -t latex -o tetris.pdf -V lang -V babel-lang=russian cyrillic.md

或者使用Markdown中的Babel命令切换语言

# Header

## Subheader

Tetris (Russian: \foreignlanguage{russian}{Тетрис}) quoting Wikipedia 
is a tile-matching puzzle video game

用

运行

pandoc -t latex -o tetris.pdf -V lang -V babel-lang=english \
       -V babel-otherlangs=russian cyrillic2.md

希

原始帖子中的示例包含来自主要和扩展希腊语Unicode代码页的字符。

无论如何，广泛使用的LGR希腊字体编码不包含在LaTeX 3项目中，并且被归类为本地编码，即它可能因站点而异，也可能因系统而异。 LaTeX Encoding Guide

在TeX Live上，需要安装以下软件包：texlive-greek-inputenc，texlive-greek-fontenc和texlive-cbfonts。 请注意，您需要使用Babel 3.9或更高版本。但是结果

pandoc -t latex -o anarchy.pdf -V fontenc=LGR greek.md

可能会出乎意料。

为了纠正这个问题，必须正确设置LaTeX Babel包。并插入命令以在原始文本中切换语言：

# Header!

## Sub Header

themselves derived respectively from the Greek \textgreek{ἀναρχία} 
i.e. 'anarchy'

使用以下命令进行编译

pandoc -s greek2.md -t latex -V fontenc=T2A -V lang -V babel-lang=english \
    -V babel-otherlangs=greek -o greek.pdf

将完全按照您的预期生成输出：

XeLaTeX

如果我们使用XeLaTeX，则不需要所有这些。

只需使用

运行原始示例

pandoc -s greek.md --latex-engine=xelatex -t latex -o greek.pdf

会产生

因为字体在希腊字符位置中不包含任何内容，所以输出包含一些空格。

选择一种流行字体作为新mainfont会有所帮助

pandoc -s greek.md --latex-engine=xelatex \
    -V mainfont="Liberation Serif" -t latex -o greek.pdf

然而，扩展的希腊语代码页中的字符（例如带有psili accent的小写字母alpha ）不会呈现。

Font Setup for Greek with XeTeX/LuaTeX指南建议使用DejaVu，Libertine或Free字体系列。

确实使用DejaVu Serif，Linux Libertine O以及Tempora以及其他一些字体，结果将符合预期。请参阅下面使用XeLaTeX和Linux Libertine字体进行渲染。

pandoc -s greek.md --latex-engine=xelatex -V mainfont="Linux Libertine O" \
      -t latex -o greek.pdf

Answer 4

如果您正在使用LaTeX中间输出，则可以使用内联\mbox{t\'ext}来获取重音字符。如果没有\mbox{}，Pandoc解析器通常无法正确解释反斜杠。

Answer 5

您可以使用--latex-engine=xelatex，如前所述，但是我发现最好的方法是使用lang变量在标头中指定文档语言，例如：lang: ru-RU。我的debian工作站上的工作示例：

---
title: Lady Macbeth de Mzensk (Chostakovitch, livret d'Alexandre Preis, 1934)
lang: ru-RU
---

# Acte I / Tableau 1

*[Народ ненадежный]*  
Ха, ха, ха, ха, ха, ха, ха. *[...]* Чуыствуем  
На кого ты нас покидаешь?  
Без хозяина будет скучно,  
скучно, тоскливо, безрадостно.

Не работа. Без тебя невеселье. Воз вращайся  
Как можно скорей, скорей !

然后您可以启动：

$ pandoc -o your-file-output.pdf your-source-file.md

Answer 6

我有一个类似的问题，试图让数学符号出现在输出中。

就像其他人提到的那样，在最新的pandoc版本（以我的情况为v2.2.3.2）中，使用的选项为pdf-engine=xelatex。在这种情况下，我不需要指定字体：

pandoc -o MyDoc.pdf --pdf-engine=xelatex  MyDoc.md

我确实收到一个错误，指出缺少拉丁现代数学字体。我使用以下方法安装了它：

tlmgr install collection-fontsrecommended

Answer 7

适用于西里尔字母

pandoc myfile.md --pdf-engine=xelatex -V mainfont=Arial

潘多克和外国人物

7 个答案:

如何查找支持您语言的字体

西里尔

希

XeLaTeX