3 ms·

asciidoc anyone?

• schaefer 2y ago
  I keep my journal in a blend of asciidoc and markdown. In asciidoc, I love xref soooo much, which lets you make cross-document links to .adoc files that still work after being translated to html. But I'm so sad that asciidoc isn't supported by pandoc.
  • argonaut68 2y ago
    +1. My current workaround is the use of asciidoctor to convert my docs to docbook. This format is supported by pandoc.
• papascrubs 2y ago
  Right? So many features, and much easier to write than RST in my opinion. You can do things like dynamically reference other files to build tables: [%header,format=csv] |=== include::tracks.csv[] |=== What about only including specific lines? Say from a log file or a separate piece of code? You can do that! [source,python] |=== include::example.py[lines="1..10,15..20"] |=== Asciidoc solves nearly every problem I've ever run into with markdown and RST. I really wish it were more widely adopted.