Conversation

Notices

1. Hallå Kitteh (clacke@social.heldscal.la)'s status on Wednesday, 07-Mar-2018 12:39:47 UTC Hallå Kitteh
   http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/
   
   Yep, we ran into this at my previous work, where two parts of the company had standardized on a separate Markdown for documentation. Luckily one of them had just recently began, so we could force them into the pre-existing choice.
   
   In our case it was pandoc vs doxygen and we were already making use of tables as they are written in doxygen markdown, which is apparently a dialect of Markdown Extra, which has several implementations.
   
   https://www.stack.nl/~dimitri/doxygen/manual/markdown.html#markdown_extra
   
   https://en.wikipedia.org/wiki/Markdown#Markdown_Extra
   
   > Markdown Extra is a lightweight markup language based on Markdown implemented in PHP (originally), Python and Ruby.
   • Hallå Kitteh (clacke@social.heldscal.la)'s status on Wednesday, 07-Mar-2018 17:31:16 UTC Hallå Kitteh

     • 🔌💘🐶
     @usblovedog I quite like Markdown for producing html, but I've written rST and liked it, and it has better mappings to pdf et al, plus the extensibility mentioned.
     
     Now that I've learned that asciidoc is actually plaintextified DocBook, I'm very much leaning toward it, and I understand why my client chose to go with it.
     
     Textile isn't much of anything, is it? I thought it's just bold, cursive, and automatic linkification of URL-like words? Good for microblog posts but not much else? I could be wrong, but I've only seen it used as a GNU Social plugin.
   • Hallå Kitteh (clacke@social.heldscal.la)'s status on Thursday, 08-Mar-2018 02:46:13 UTC Hallå Kitteh

     • Aerdan 🦊
     • 🦊⛮ Better than the real thing!
     • 🔌💘🐶
     @usblovedog @aerdan @azure Looking at https://en.wikipedia.org/wiki/Textile_%28markup_language%29 it seems in wider and more productive use than I thought.