文章摘要
作者在撰写多本书籍后，从Markdown转向使用reStructured Text（rST），认为rST比Markdown更强大。rST作为中等权重的文档树表示，提供了更丰富的功能和灵活性，而Markdown仅是HTML的轻量级表示。作者通过对比图片插入的语法，展示了rST在处理复杂文档时的优势。
文章总结
为什么我更喜欢rST而不是Markdown
作者Hillel Wayne在文章中详细解释了他为什么更喜欢使用reStructured Text（rST）而不是Markdown来编写文档。尽管rST的学习曲线比Markdown更陡峭，但作者认为rST在处理复杂文档时具有显著优势。
rST与Markdown的主要区别
Markdown是一种轻量级的HTML表示法，而rST则是一种中等权重的抽象文档树表示法。Markdown的语法简单，适合快速编写，但功能有限。相比之下，rST的语法虽然复杂，但提供了更强大的扩展性和灵活性。
rST的优势
扩展性：rST允许用户通过自定义指令来扩展功能。例如，作者在编写《Logic for Programmers》时，创建了一个自定义的“练习”指令，用于在文档中插入练习和解答，并根据不同的输出格式（如HTML、epub和LaTeX）进行不同的渲染。
文档树处理：rST允许在渲染前对文档树进行转换。这使得处理交叉引用、移动节点等操作变得非常方便。例如，作者在生成epub和LaTeX时，会将解答部分移动到文档的末尾，并在练习部分插入指向解答的链接。
Markdown的局限性
尽管Markdown因其轻量级和便携性而广受欢迎，但它在处理复杂文档时显得力不从心。许多基于Markdown的文档生成器不得不通过预处理步骤来支持新功能，但这些功能往往受到Markdown语法的限制，无法充分发挥其潜力。
结论
作者强调，虽然rST的语法可能不如Markdown简洁，但它在处理大规模文档时提供了更强大的工具和灵活性。对于那些需要处理复杂文档的开发者来说，rST是一个值得考虑的选择。
其他选择
对于那些不喜欢rST语法的开发者，作者还推荐了其他文档生成工具，如AsciiDoc、MyST、Typst、Pollen和Pandoc扩展的Markdown。这些工具各有特点，开发者可以根据自己的需求选择合适的工具。
关于《Logic for Programmers》
作者还简要介绍了他的新书《Logic for Programmers》，该书探讨了形式逻辑在日常软件工程中的应用，目前处于早期访问阶段，欢迎读者反馈。
总结
尽管rST的语法可能不如Markdown简洁，但它在处理复杂文档时提供了更强大的工具和灵活性。对于那些需要处理大规模文档的开发者来说，rST是一个值得考虑的选择。
评论总结
评论主要围绕RST（reStructuredText）和Markdown的优缺点展开，观点分为支持RST和支持Markdown两派，部分评论也提到了其他工具如AsciiDoc、Djot和Typst。
支持RST的观点：
1. 功能强大且扩展性强：RST适合复杂文档和书籍编写，支持丰富的扩展功能，如索引、术语表等。
- "The builtin features for glossary and index are also nice. The extensibility is amazing." (acidburnNSA)
- "Everyone who works seriously with editing and formatting documentation for presentation prefers RST." (ajross)
- 适合技术文档：RST在处理复杂技术文档时表现优异，尤其适合需要生成多种格式（如HTML、PDF、EPUB）的场景。
- "I would definitely not want to go to Markdown from RST for technical documentation that's more complex than a Github readme." (Firehawke)
支持Markdown的观点：
1. 简单易用：Markdown语法简单，易于阅读和编写，适合日常笔记和轻量文档。
- "Markdown is ubiquitous because it’s easy for humans to read and write." (tambourine_man)
- "Markdown may or may not be the best tool for writing a book, but Markdown is the best tool for what it does - quickly writing formatted text." (Arainach)
- 广泛支持：Markdown解析器几乎支持所有编程语言，且在许多平台（如Slack、Obsidian）中直接使用。
- "Markdown parsers exist in any language I care to use." (jeberle)
其他工具的观点：
1. AsciiDoc：作为RST和Markdown的折中方案，功能丰富且易于使用。
- "'asciidoc' is the middle ground." (betaby)
Djot：Markdown的改进版，支持更多功能如表格和属性，同时保持简单性。
- "As a compromise, I prefer Djot to markdown." (lawn)
Typst：有人对其在简单文档中的易用性表示兴趣，但未深入讨论。
- "I'm interested in people's opinion of typst's ease of writing and reading." (freeopinion)
总结：RST在复杂文档和技术写作中更具优势，而Markdown因其简单性和广泛支持更适合日常使用。其他工具如AsciiDoc和Djot则提供了中间选择。