使用 SFFMS 使用 Pandoc 将 Markdown 转换为 PDF

Convert Markdown to PDF with Pandoc Using SFFMS

我希望能够使用 Pandoc to convert my stories from Markdown to PDF files, formatted using sffms。我尝试了一些事情,但到目前为止,没有任何快乐。我对命令行相当满意,但 LaTeX 对我来说是新手。

这是我到目前为止所做的。

  1. 我安装了 Pandoc v.1.13.2
  2. 在pandoc的默认用户目录下,我创建了一个文件夹,templates
  3. 在该文件夹中,我从 the example as well as the other default templates
  4. 安装了 mytemplate.tex
  5. 同样在该文件夹中,我已经安装了 sffms 所需的文件,注意 运行 安装命令 latex sffms.ins

我的 Markdown 文件,sample.md 看起来像这样:

---  
title: Document Title 
author: Firstname Lastname
date: 2015-01-24
---      


# Section 1  

## Subsection 1.1  
Lorem *ipsum* dolor sit amet, **consectetur** adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque  ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.

## Subsection 1.2    

# Section 2    

# Section 3    

A sentence that needs a note.[ˆ1]     

[ˆ1]: my first footnote! And a [link](https://www.eff.org/)

当我使用以下内容时,Pandoc 能够使用默认文档 class:

创建 PDF
pandoc --standalone --smart sample.md -o manuscript.pdf

接下来,我尝试添加变量来指示文档 class...

pandoc --standalone --smart --variable documentclass=sffms sample.md -o manuscript.pdf

...但这导致了以下错误:

! Paragraph ended before \UL@on was complete.
<to be read again> 
                   \par 
l.56 

问题似乎是 sffms 不支持章节标题。如果我使用支持章节标题的不同文档 class,那么一切都会按预期进行。

是否可以使用 sffms,即使 markdown 文件有副标题,也不会出现错误?

事实证明,sffms 文档不支持节、小节及其关联的副标题。作者可能会在未来的版本中添加对此的支持。

在那之前,对此的一个答案是使用不同的文件 class。我通过 scrartcl 文档 class 草拟了 a Pandoc template that give more-or-less analogous formatting。这可能是草率的,是第一次尝试,但它大部分都有效。