6 ms·
The only drawback of Markdown is images. GitHub-flavored Markdown is so popular because you can really easy inline them. You don't have to worry about storing
by hartator 2y ago
The only drawback of Markdown is images.
GitHub-flavored Markdown is so popular because you can really easy inline them. You don't have to worry about storing them, linking them correctly, and you can even paste to the Markdown field.
There is no elegant solution like this in actual Markdown.
- darkteflon 2y agoI would add tables to that. Obsidian has some nice extensions to make working with tables easier, but it always feels janky.
- hartator 2y agoYeah, what people like about Markdown is basically regular text. The formatting is interesting, but it’s not revolutionary or anything.
- josephg 2y agoMarkdown is also missing: - Diagrams - Math - Any custom blocks - like Figures, algorithms, image boxes, etc - Numbered chapters / sections (Eg Chapter 1, Appendix A, etc). - Semantic references For readmes, thats fine I guess. But I miss all those features when I'm writing proper blog posts, articles and documentation. There are various hacky workarounds. But as soon as you start using bespoke markdown extensions, you're locked out of 95% of the markdown tooling out there. And everything feels so janky. I'm looking forward to Typst's HTML output getting more mature. Typst is the only typesetting tool I've ever used that is both enjoyable to use and powerful enough for the kind of documents I want to write. It manages that by being a full on programming language. You can define variables and write custom functions for reused blocks. And there is an ecosystem of 3rd party typst packages. For a paper I wrote recently, my benchmarking tool spat the results into a JSON file. My document loaded that JSON data directly, and used the benchmarking results to populate charts and tables in the paper. It was crazy cool.
- Refusing23 2y agoi do believe obsidian support all those (well maybe not all) but thats added 'on top' of basic markdown, so when you open your markdown file in some other program it looks weird
- DavideNL 2y agoMore importantly, when that specific plugin stops being maintained/updated, you’ll have Markdown files which can’t be properly presented/read.
- ozim 2y agoMarkdown should not do diagrams/math etc. People just started doing all kinds of extensions and for me that’s silly.
- josephg 2y ago> Markdown should not do diagrams/math etc. Fine. But in that case, markdown is the wrong tool for blogging and documentation. I want to write rich and interesting content. Markdown is anaemic.
- out_of_protocol 2y agoMermaid charts! Supported by github and very readable as plaintext https://github.blog/developer-skills/github/include-diagrams-markdown-files-mermaid/ https://github.blog/developer-skills/github/include-diagrams...
- josephg 2y agoI put that in the "hacky workarounds" category. Does it work at all? Yeah. Does it work in my markdown editor? Probably not. Does it work in my markdown renderer? I don't know. Which version of Mermaid does it work with? Probably a different version of mermaid on every platform. Can I save my mermaid diagram to a file and link it instead of inlining the mermaid diagram inline? Who knows. Flip a coin everywhere mermaid is supported. I tried pushing a markdown renderer to the limits once - only to find out that the markdown renderer I was using doesn't correctly implement commonmark, and my markdown file breaks with every other markdown renderer I've tried it with. To say nothing of the custom extensions I tried to use. At this stage I'd rather keep my markdown files simple, and use something better for real documents. Something like typst.
- deleted 2y ago[deleted]
- jorams 2y ago> The only drawback of Markdown is images. > GitHub-flavored Markdown is so popular because you can really easy inline them. I'm not sure what you mean. GitHub-flavored Markdown has pretty much exactly the same image syntax as every other Markdown flavor.
- ytjohn 2y agoI think they're mixing the GH web ui with the syntax. You can paste an image right into the editor and it does a really good job of inserting it right where you need to. It is really good UX that I miss when editing markdown locally. Obsidian also does a decent job, but not quite as smooth.
- everybodyknows 2y agoSounds like powerful lock-in for Github. How could such a project ever decamp to Gitlab or Codeberg?
- ytjohn 2y agoSo I also do use gitlab quite a bit, but not as much recently. I went to compare. Gitlab actually does have a similiar ux experience, though I'd give the Github one just a bit of an edge. It looks like the key difference is that github converts a pasted image to an html image tag, while gitlab uses markdown with the width/height brackets that the end. Honestly, I think using an html image tag is the right way to go. I type in markdown all the time, and I have no problem making links. But markdown image syntax I have to double check each time or let the editor figure it out. HTML image tags, I find easier to remember and read than a markdown one. (But maybe that's because I learned HTML before markdown).
- jhoechtl 2y agoSounds like powerful UX others could also supports. Its all web stanards.