用 Pandoc 生成一篇调研论文
学习如何用 Markdown 管理章节引用、图像、表格以及更多。<a href="https://dn-linuxcn.qbox.me/data/attachment/album/201811/01/130402un9z690xd92o60ik.jpg">Media</a>这篇文章对于使用 <a href="https://en.wikipedia.org/wiki/Markdown">Markdown</a> 语法做一篇调研论文进行了一个深度体验。覆盖了如何创建和引用章节、图像(用 Markdown 和 <a href="https://www.latex-project.org/">LaTeX</a>)和参考书目。我们也讨论了一些棘手的案例和为什么使用 LaTex 是一个正确的做法。调研调研论文一般包括对章节、图像、表格和参考书目的引用。<a href="https://pandoc.org/">Pandoc</a> 本身并不能交叉引用这些,但是它能够利用 <a href="http://lierdakil.github.io/pandoc-crossref/">pandoc-crossref</a> 过滤器来完成自动编号和章节、图像、表格的交叉引用。让我们从重写原本以 LaTax 撰写的 <a href="https://dl.acm.org/citation.cfm?id=3270118">一个教育调研报告的例子</a> 开始,然后用 Markdown(和一些 LaTax)、Pandoc 和 Pandoc-crossref 重写。添加并引用章节要想章节被自动编号,必须使用 Markdown H1 标题编写。子章节使用 H2-H4 子标题编写(通常不需要更多级别了)。例如一个章节的标题是 “Implementation”,写作 # Implementation {#sec: implementation},然后 Pandoc 会把它转化为 3. Implementation(或者转换为相应的章节编号)。Implementation 这个标题使用了 H1 并且声明了一个 {#sec: implementation} 的标签,这是作者用于引用该章节的标签。要想引用一个章节,输入 @ 符号并跟上对应章节标签,使用方括号括起来即可: [@ sec:implementation]<a href="https://dl.acm.org/citation.cfm?id=3270118">在这篇论文中</a>, 我们发现了下面这个例子:<pre class="prettyprint linenums">we lack experience (consistency between TAs, [@sec:implementation]).</pre>Pandoc 转换:<pre class="prettyprint…
学习如何用 Markdown 管理章节引用、图像、表格以及更多。<a href="https://dn-linuxcn.qbox.me/data/attachment/album/201811/01/130402un9z690xd92o60ik.jpg">Media</a>这篇文章对于使用 <a href="https://en.wikipedia.org/wiki/Markdown">Markdown</a> 语法做一篇调研论文进行了一个深度体验。覆盖了如何创建和引用章节、图像(用 Markdown 和 <a href="https://www.latex-project.org/">LaTeX</a>)和参考书目。我们也讨论了一些棘手的案例和为什么使用 LaTex 是一个正确的做法。调研调研论文一般包括对章节、图像、表格和参考书目的引用。<a href="https://pandoc.org/">Pandoc</a> 本身并不能交叉引用这些,但是它能够利用 <a href="http://lierdakil.github.io/pandoc-crossref/">pandoc-crossref</a> 过滤器来完成自动编号和章节、图像、表格的交叉引用。让我们从重写原本以 LaTax 撰写的 <a href="https://dl.acm.org/citation.cfm?id=3270118">一个教育调研报告的例子</a> 开始,然后用 Markdown(和一些 LaTax)、Pandoc 和 Pandoc-crossref 重写。添加并引用章节要想章节被自动编号,必须使用 Markdown H1 标题编写。子章节使用 H2-H4 子标题编写(通常不需要更多级别了)。例如一个章节的标题是 “Implementation”,写作 # Implementation {#sec: implementation},然后 Pandoc 会把它转化为 3. Implementation(或者转换为相应的章节编号)。Implementation 这个标题使用了 H1 并且声明了一个 {#sec: implementation} 的标签,这是作者用于引用该章节的标签。要想引用一个章节,输入 @ 符号并跟上对应章节标签,使用方括号括起来即可: [@ sec:implementation]<a href="https://dl.acm.org/citation.cfm?id=3270118">在这篇论文中</a>, 我们发现了下面这个例子:<pre class="prettyprint linenums">we lack experience (consistency between TAs, [@sec:implementation]).</pre>Pandoc 转换:<pre class="prettyprint…