寻找一个很好的文档格式

Question

我有一个相当大的爱好项目，我不想迷路，所以我离开课程记录，可能是“设计文档”或“手册”，但我还没有找到了一个很好的格式，所有的文档都分布在.txt .doc .odt等文件中，也许你可以帮助我:-)？

真正最好是有格式：

• 一个文件只（而不是HTML为例）
• 轻松添加图像，大/小/粗体/下划线/ ...文本。
• 使用简单优选在左侧（不需要“编译”，无需使用天然气为动力的编辑器/简单编辑）
• 的可折叠“索引”
• 可以（容易）读在多台计算机（PC是必须的，但如果它在Mac等。这将是很好）

我已经尝试过的.odt

免费或不是很昂贵（至少一个自由和良好的阅读器） ，powerpoint和.pdf，但他们有明显的问题（odt：没有索引，ptt：昂贵和PC只，pdf：拥有这一切，我认为但没有（好）免费编辑器）。

你在记录文件时使用了什么，你有关于适合我的格式的想法吗？

谢谢！

事实上，我发现Open Office文本文档使用不同的标题并导出为pdf会自动生成书签（对于标题，可折叠），这就是我搜索的内容。 由于问题只有一个答案（谢谢！但它不是我正在寻找），我不能回答我的问题，我会让它成为...

Answer 1

你试过Markdown ？这就是我编写所有冗长的文章的方式，因为Markdown本身非常易读（这就是整个论点），并且可以通过任何文本编辑器进行编辑。但使用模板引擎（我使用Jinja2），您可以很好地吐出统一的文本文档组。

• 这是a sample article用Markdown写的。
• 和resulting HTML file。
• 和global template file。

如果您想查看一些语法示例，维基百科上有一篇很好的文章：http://en.wikipedia.org/wiki/Markdown#Syntax_examples。