使用pandoc將markdown轉換為pdf時如何強制圖像到文本

Question

我制作了一個GitHub wiki - 一個軟件包的手冊 - 我想把它變成一本漂亮的pdf手冊。 但是，我在使用數字方面遇到了一些麻煩 - 其中很多都放在下面的一個頁面中，大部分都放在文本中應該是的位置之后，是什么讓文檔很難閱讀。

為此，我基本上遵循了這里建議的內容。 基本上這個想法是：

1. 克隆GitHub wiki;

2. 使用pandoc將markdown文件轉換為單個pdf：

   pandoc -s FirstSection.md FirstSection.md FirstSection.md -o manual.pdf

會發生什么事情，我有一系列短句，每個句子后跟一個數字（例如，看看這里 ）。 當我打開生成的pdf時，每個數字都不在wiki之前的句子之后，而是我有一系列的句子和連續的序列圖，但它使文檔很難遵循。

有沒有辦法強制圖像在放置它們的文本后面，並避免在圖像之前有文字？

我找到了一些Rmarkdown的解決方案，但它們對我不起作用。

提前致謝！

Answer 1

Pandoc 默認使用LaTeX進行PDF創建 。

使用外部文件

將以下內容放在header.tex ：

\makeatletter
\def\fps@figure{h}
\makeatother

或者， 以下內容 ：

\usepackage{float}
\let\origfigure\figure
\let\endorigfigure\endfigure
\renewenvironment{figure}[1][2] {
    \expandafter\origfigure\expandafter[H]
} {
    \endorigfigure
}

然后使用：

pandoc input.md --include-in-header header.tex -o output.pdf

僅使用markdown文件

或者，您也可以將其嵌入到markdown文件的YAML元數據塊中 ，而不是使用header.tex ：

---
header-includes: |
  \makeatletter
  \def\fps@figure{h}
  \makeatother
---

# my markdown header