4 ms·
This looks really nice... ... except like every other apps around there it only supports Markdown Feature request: Please add an option to convert the result
by jmfayard 7y ago
This looks really nice...
... except like every other apps around there it only supports Markdown
Feature request:
Please add an option to convert the resulting file to a better format like Asciidoc and other better markup formats
Maybe using pandoc.
WHY?
I feel unwell with Markdown
Markdown deserve credits for having found a real important problem to solve
on the other hand, it's not a good solution to that problem
... but just good enough that its bad aspects are not obvious
Combined with its current popularity, this makes progress very hard
But there are so much things that are wrong with Markdown.
Nested lists? I get them wrong every time.
Images syntax is bad.
Tables syntax is worse.
No table of contents.
You can't have variables.
You can't include another file.
In the end, every website does its own markdown because Markdown sucks.
Interopability? Ah ah. Some have tried.
That's a rabbit hole to get into.
In the end, Markdown is just a starting point... To a real format like Asciidoc.
- bhl 7y agoDo you have a suggested improved syntax for images and tables? I think Table of Contents exist in some implementations of Markdown but it’s not common.
- jmfayard 7y agoYes I have! I am gradually switching to Asciidoctor because it solved all the pain points I cited (and more) > Table of contents That's simply :toc: > Images Doing better is easy, plain HTML is better than Markdown. For example: image::sunset.jpg[] or [link=https://www.flickr.com/photos/javh/5448336655 https://www.flickr.com/photos/javh/5448336655] image::sunset.jpg[Sunset,300,200] or Click image:icons/play.png[Play, title="Play"] to get the party started. https://asciidoctor.org/docs/user-manual/#images https://asciidoctor.org/docs/user-manual/#images > Tables See https://asciidoctor.org/docs/user-manual/#tables https://asciidoctor.org/docs/user-manual/#tables
- alias_neo 7y agoWhat I need is something that let's me write my docs in markdown and then quickly and easily render them to PDF with nice output, runs on Linux, and doesn't render remotely. I've used Grip, and I use the Markdown to PDF plugin in VSCodium but none of these really meet the requirements.