使用Markdown+Pandoc+LaTex+Beamer制作幻灯片

概述

为什么使用markdown？

mardown是一种轻量级的标记语言，语法简单，可读性好，并且容易转化成其他格式的文档，在技术文档撰写中得到越来越广泛的应用。相信大家对markdown都有一定了解，如果不了解搜一下网上有大量结果，语法可以参考Markdown 语法说明 (简体中文版)。笔者现在写文档和ppt逐渐的从office转移到了markdown上，它的好处是

纯文本
- 便于编辑
- 可以用版本管理工具进行管理
- 可移植性好
内容和格式分离
- 写作的时候可以专注于内容
- 修改格式时，一处修改，各处生效

本文简单介绍一下用markdown制作幻灯片的过程。

基本过程和工具

mardown制作幻灯片的流程一般是：先用markdown写文本文件，然后使用工具转化为html或pdf等格式。这个过程如有必要，可修改css或tex模板。用到的工具有：

任何文本编辑器：用于编辑markdown源文件
pandoc：将markdown转换成其他格式（本文主要介绍pdf）的工具
latex：pandoc将markdown转换成pdf时，需要用到latex引擎。如果要支持中文，可以装xelatex
beamer：latex下制作幻灯片的工具包

当然，直接用latex+beamer就可以制作幻灯片，但是需要写tex源文件，比较麻烦而且可读性不如markdown。所以我采用markdown写内容，tex做模板的方式。

一个基本的幻灯片

编辑markdown源文件

pandoc将markdown的一级标题视为幻灯片组，将二级标题视为幻灯片标题，二级标题下的内容放在一张幻灯片里。不过，如果某个一级标题下没有二级标题，那么pandoc将把一级标题视为幻灯片标题，将这个一级标题下的内容放在一张幻灯片里，二级标题显示为子框。

在任何时候，用‘---------’都可以产生一张新幻灯片。

pandoc对markdown有个扩展，在前面加上三行以%开头的内容，分别是标题、作者和日期。

例子如下

% Title
% auther
% date

# This is a group

## This is title 1

  This is first slide

  - item 1
  - item 2

## This is tile 2

  This is second slide

-------------

  This is third slide

转换为pdf

将上述代码保存为exam1.md，运行

pandoc -t beamer -o exam1.pdf exam1.md

即可生成pdf。

pandoc对markdown的扩展

pandoc出了支持标准的markdown语法，还作了一些很实用的扩展，上面的标题、作者和日期就是。此外比较实用的还有表格、公式等。详见pandoc的文档。

表格

pandoc支持用文本标识的表格，如

 A B  C
-- -- --
 a b  c

或者

| A | B | C |
|---|---|---|
| a | b | c |

公式

pandoc支持latex的公式语法，在$ ... $之间即可插入行内公式。如果要使公式单独占一行，使用两个$即可，即$$ ... $$。

中文支持

要正常显示中文，需要注意两点：

使用xelatex引擎
在模板文件中正确配置

首先导出pandoc的beamer默认配置

pandoc -D beamer > beamer-template.tex

在\ifxetex后面加入对中文的支持

\usepackage{xeCJK}                 % 设置中英文字体
\setCJKmainfont{WenQuanYi Micro Hei} % 中文字体
\setmainfont{Arial}                % 英文字体
\setromanfont{Courier New}
\setmonofont{Courier New}
\linespread{1.2}\selectfont        % 行距
\XeTeXlinebreaklocale "zh"         % 中文自动换行
\XeTeXlinebreakskip = 0pt plus 1pt % 字之间加0pt至1pt间距
\parindent 0em                     % 段缩进
\setlength{\parskip}{20pt}         % 段间距

编译时使用命令

pandoc -t beamer --latex-engine=xelatex --template=beamer-template.tex xx.md -o xx.pdf

实用技巧

设置页面比例

在模板文件的documentclass中加入参数aspectratio=169，即

\documentclass[..., aspectratio=169]{$documentclass$}

即可设置页面比例为16:9(默认为4:3)。

设置背景图片

笔者在工作中，需要使用公司的ppt模板，因此需要设置幻灯片的背景。最终采用的解决方法是这样的：

在模板文件中加入命令

\usebackgroundtemplate{\includegraphics[width=\paperwidth, height=\paperheight]{background.png}}

如果要对标题页单独设置背景，笔者用的是这篇文章里的方法:

\RequirePackage{tikz}
\addtobeamertemplate{title page}{%
    \begin{tikzpicture}[remember picture,overlay]
        \node [xshift=0cm,yshift=0cm] at (current page.center)
            {\includegraphics[width=\paperwidth, height=\paperheight]{background_title.png}};
    \end{tikzpicture}%
}{}