包含标准标题的Markdown

时间:2014-08-28 17:15:20

标签: python ruby markdown

我想标准化我的技术文档。为了简化它,我想使用markdown,但我也希望它包含标准的页眉和页脚以及版本控制。

如何在每个新文档中包含页眉和页脚?

我想要这样的事情:

部首:

####My Company
![](http://image/file.jpg)
---

页脚:

---
<sup>File version:[version]</sup>
<sup>Compiled [date]</sup>

然后每个技术文档都是这样的:

{include header.md}

- technical
- stuff
- and 
- other stuff

{included footer.md}

然后当转换为html或pdf时,它们只会将它们组合成一个漂亮的文档。

或者,如果您可以将多个文档编译成一个这样的输出:

marddown2pdf header.md body.md footer.md -o output.pdf

这也会起作用(例如,该命令的语法已经构成)

在重新发明轮子之前,有没有办法在使用python或ruby之前实现这一点?

感谢。

1 个答案:

答案 0 :(得分:0)

很大程度上取决于具体实施。 Pandoc通过template variables支持此功能。启动黑客模板的好地方可能是查看pandoc-templates Git存储库,看看您可以在license中利用什么。