Live data from Hacker News

Shrimple – A Simpler, Nicer Markdown

qount25.dev

31–40 of 43 posts

Re: Shrimple – A Simpler, Nicer Markdown

#31
post #5

How does this compare to RST, which also claims to solve specific MD inconveniences? In researching for this reply I see that it's joining a somewhat crowded field https://en.wikipedia.org/wiki/Comparison_of_document_markup_...

RST is pretty much the worst option out there. Your mainstream options are:

* Markdown. Great for simple stuff. It's going to be awkward if you're writing a book or technical docs or whatever.

* RestructuredText. Better for more complex documents but the Python code that drives it is abysmal and it's less popular than Asciidoc so there's really no reason to use this.

* Asciidoc. Definitely a step up from RST but it does have syntax weirdnesses, and the way parsing is done is a messy pile of hacks. Also Asciidoctor is written in Ruby which makes it horrible to work with. But tbh still better than RST due to the low quality of their Python code & docs.

* Typst. Definitely the best option for complex stuff except that its HTML output support is still experimental. You can make it work nicely with some fiddling and custom CSS though.

Overall Markdown and Asciidoc are the best options today, or Typst instead of Asciidoc if you are forward-looking.

This thing just looks like a slight tweak on Markdown which is completely pointless compared to the pain of .. you know, not being supported by any other tools at all.

Re: Shrimple – A Simpler, Nicer Markdown

#32
post #2

Indent for code blocks is a non-starter. Can't paste easily, very annoying to type in a web form. Triple backticks is the right thing.

That said, I think it would be better if the closing delimiter was different from the opening one. Yesterday I had an LLM output text where it forgot one of the delimiters, causing all text inside code blocks to actually be outside and vice-versa.

Re: Shrimple – A Simpler, Nicer Markdown

#33
post #18

About five years ago I faced the fact no two Markdown implementations are fully compatible. I made StrictMark[1], which is a backwards-compatible Markdown dialect with a formal grammar (I use Ragel for parser generation btw). Takes 5-10 min with LLMs to make any implementation, cause formal grammar is unchanged. I use it, no one else does, which is not an issue cause it is backwards-compatible. GitHub renders it fine…

How does it compare to CommonMark, which I think was the first formally specified Markdown dialect?

CommonMark spec[1] is laaarge and not formal (no grammar). StrictMark has block-level[2] and inline[3] grammars, 100+ and 200+ lines of Ragel code respectively. May parse with regexes too, and results will be identical.

[1]: https://spec.commonmark.org/0.31.2/

[2]: https://github.com/gritzko/beagle/blob/main/dog/tok/MKDTB.c....

[3]: https://github.com/gritzko/beagle/blob/main/dog/tok/MKDT.c.r...

Re: Shrimple – A Simpler, Nicer Markdown

#34

Having the dashes to make something a headline on another row disconnects meaning. You now have to edit two lines to make one change. Same for the code part. This might be easier to read but it’s not simpler.

Markdown itself introduced that syntax. Though it’s not used nearly as much as it was initially, it’s one of the main features that make it very readable in plain text.

Re: Shrimple – A Simpler, Nicer Markdown

#37
post #5

How does this compare to RST, which also claims to solve specific MD inconveniences? In researching for this reply I see that it's joining a somewhat crowded field https://en.wikipedia.org/wiki/Comparison_of_document_markup_...

RST is pretty much the worst option out there. Your mainstream options are: * Markdown. Great for simple stuff. It's going to be awkward if you're writing a book or technical docs or whatever. * RestructuredText. Better for more complex documents but the Python code that drives it is abysmal and it's less popular than Asciidoc so there's really no reason to use this. * Asciidoc. Definitely a step up from RST but it d…

Why does Ruby make Asciidoctor horrible to work with?

Re: Shrimple – A Simpler, Nicer Markdown

#40
I thought about writing a markdown variant that is easier to type--every token in grammar should be easily reachable from home row and should not require more than one keypress (e.g. no #). I figured same conclusion as many in comments here: no need to reinvent the wheel. Plus, the aggregate amount of time it'd save me from typing may not exceed the time it would take to implement.
Post reply on HN