【问题标题】:Generate inline rather than list-style footnotes in Pandoc Markdown output?在 Pandoc Markdown 输出中生成内联而不是列表样式的脚注?
【发布时间】:2016-03-03 06:25:22
【问题描述】:

当从某种格式(例如,HTML 或 Docx)转换为 Pandoc 中的 Markdown 时,是否可以以内联样式呈现所有脚注(“这是正文^[这是一个脚注]”)而不是作为编号的参考文献在文件末尾有相应的列表?我想将我的 Markdown 文档(从我的论文的 Docx 转换而来)作为主文本,但现在如果我添加一个新的脚注,它会弄乱编号。

或者,是否有另一种方便的方式(即不是 Pandoc)可以做到这一点?在文件的一部分中剪切文本并在另一部分中添加相应的文本似乎有点超出了简单的正则表达式。

提前感谢您的帮助。

编辑:我刚刚破解了 an extremely simple Python script 来做这件事,以防其他人有同样的问题。

【问题讨论】:

  • 嗯,我想说你想要的输出在 Markdown 中甚至不是有效的脚注,但后来我检查了,Pandoc 实际上接受了它作为脚注。由于 Pandoc 是我知道的 only Markdown 实现,它接受该语法,因此我会尽可能避免它。这似乎是一个糟糕的设计决定。

标签: regex markdown pandoc footnotes


【解决方案1】:

Pandoc 的 Markdown 语法对于footnotes 相当灵活:

脚注本身不需要放在文档的末尾。它们可以出现在除其他块元素(列表、块引用、表格等)之外的任何地方。

喜欢:

Here is a footnote reference[^1] and some more text.

[^1]: Here is the footnote.

Here's the next paragraph.

然而,Markdown Writer(生成 Markdown 文件的模块,而不是读取它们)目前只是文档的places all of them at the end。但这可以在标志后面实现,类似于--reference-links 标志。随时提交问题或拉取请求!

【讨论】:

    【解决方案2】:

    内联脚注和参考对于编写和编辑 Markdown 文档来说非常好,但对于阅读它们来说很麻烦。

    我使用ltrgoddard's inliner 成功处理了几个文件,我使用 pandoc 和 latexmk 来生成 PDF。 inliner 非常适合将结束样式引用转换为已编写文档中的内联样式引用。

    交叉引用其他问题和后代线索:

    Convert markdown links from inline to reference

    Vim plugin for adding external links

    另见http://drbunsen.github.io/formd/https://instant-thinking.de/2014/02/20/markdown-footnotes-with-vim/ 了解更多信息 re: formd,它应该适用于转换内联引用结束样式引用,反之亦然。

    请注意,formd 适用于 URL 并忽略脚注,因此这可能被视为类似项目(具有不同目标),但不是替代方案。

    【讨论】:

      猜你喜欢
      • 2022-06-30
      • 2012-03-10
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多