Post Ax9WnRGZIULWGfIdKC by winterschon@mastodon.bsd.cafe
 (DIR) More posts by winterschon@mastodon.bsd.cafe
 (DIR) Post #Ax9WnRGZIULWGfIdKC by winterschon@mastodon.bsd.cafe
       2025-08-13T23:46:42Z
       
       0 likes, 0 repeats
       
       🚯 No More Markdown 🚯Well, it's certainly not going away any time soon, but it doesn't have to be the default. While it's easily a majority of the docs formats that I have to use, it's not my favorite. Perhaps in an ideal world it would be AsciiDoc or LaTeX _All The Time_, but we don't live in that world, oh well 💋 In the interim, here's someone who wrote about the topic which seems worth sharing. Interesting points, ja?- Why You Shouldn’t Use “Markdown” for Documentation: https://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/#engineering #software #oss #foss #markdown #documentation
       
 (DIR) Post #Ax9WnSdIDU7MVQwINs by drizzy@cyberplace.social
       2025-08-14T06:12:11Z
       
       0 likes, 0 repeats
       
       @winterschon @publicvoit has written about the topic quite a bit. Most relevant might be https://karl-voit.at/2017/09/23/orgmode-as-markup-only/Though I suppose it wasn't focused on actual documentation.
       
 (DIR) Post #Ax9WnTtdWCmkQParUu by publicvoit@graz.social
       2025-08-14T06:56:28Z
       
       0 likes, 0 repeats
       
       @drizzy @winterschon I'm about to finish my long read about that. 😉