61–65 of 65 posts
Any Markdown implementation which allows for custom directives and is CommonMark-compliant is good enough for me. MyST, for example, lets you do :::{makeup-highlight} :lang: elixir defmodule A do def b, do: :ok end ::: :::{pygments-highlight} :lang: python class B: pass ::: Since MyST has intermediaries that just give you an AST, you have a lot more extensibility using directives and roles to do special things (inclu…
Does anyone know a JS renderer that supports custom directives?
Earlier quoted context omitted.
As is org-mode. I think Markdown is one of those VHS vs Betamax kind of situations where it was just lucky to get the traction that its competitors didn't.
Org-mode failed with hyperlinks and images: [[https://123.com][Description]] is way more cumbersome than Markdown's: [Description](https://123.com)
My company uses Asciidoc for documentation - for almost 20 years now - and it's really good. Now with Antora you can make searchable docs, and with Asciidoctor you can create most diagrams right within the text. We target HTML/PDF/Epub and it works really well. So you get a result that is Word-quality, but separates presentation and content, and is easy to keep under version control.
Do you also use it for company docs, policies etc, or only for software documentation? Would love to see the back of Word.
Earlier quoted context omitted.
Org-mode failed with hyperlinks and images: [[https://123.com][Description]] is way more cumbersome than Markdown's: [Description](https://123.com)
I find the use of a single type of bracket to be less cumbersome than Markdown's variant. The two extra characters don't bother me.