I really like the docs idea. I think it’s great to automatically render the side menu.

The prevalence of Markdown from agents made me work on something similar too. My Show HN for a similar cli + web based solution (https://sdocs.dev) was on the /show page a few days ago (https://news.ycombinator.com/item?id=47777633).

Sdocs is cli -> instantly rendered on web

I like the fact it doesn’t require you to install anything to get a great experience.

Despite being in the browser, the content of SDocs rendered Markdown files remain local to you. SDoc urls contain your markdown document's content in compressed base64 in the url fragment (the bit after the `#`):

  https://sdocs.dev/#md=GzcFAMT...(this is the contents of your document)... 

The url fragment is never sent to the server (see https://developer.mozilla.org/en-US/docs/Web/URI/Reference/F...: "The fragment is not sent to the server when the URI is requested; it is processed by the client").

The sdocs.dev webapp is purely a client side decoding and rendering engine for the content stored in the url fragment.

This also means you can share your .md files privately by sharing the url.

I’m working on a few new features at the moment:

1. Commenting (so you can easily comment on a markdown file and feed that back to your agent)

2. A powerful slides functionality

I would really like to see a comparison of all these tools/markup languages:

- MyST

- Pandoc

- Quarkdown

- Quarto

- Typst

Quarto and pandoc both use Pandoc Markdown (and so does https://www.zettlr.com/). But Quarkdown and Typst offer programmable markup languages like LaTeX (or HTML + Javascript). It seems the winner for the title official LaTeX successor is still not decided.

On a quick read of the docs I'm a bit worried Quarkdown doesn't have the right evaluation model for the job. Text layout typically iterates to a fixed point, because adjusting the layout of one part of the document can throw out layout at another part, require another layout pass and so on. Typst has the concept of context[1] for this. I didn't see anything in Quarkdown that seemed similar, though perhaps I missed it.

I switched from pandoc / md / LaTex to Typst for my book[2], and have been very happy with it. Programming in a modern language is nice, and Typst is much faster than pandoc + LaTex.

[1]: https://typst.app/docs/reference/context/

[2]: https://functionalprogrammingstrategies.com/

I don’t think adding things to markdown is a good way to go. Markdown is just a poor language, period. Alternatives like Asciidoc make much more sense IMHO.

It's nice in that it extends markdown rather than reinventing a different syntax.

But the point of markdown, is to simply, markdown. Everything beyond that is deemed superfluous and cumbersome as it would defeat the point. Just write things down.

It's the right balance between plain text and latex and the rest.

Nice! But in the Comparison should be MyST - https://mystmd.org/ This is the new markdown standard to be….

I was looking for something like this, but would love if it had CV formatted doc. I just want something easy to update, but easier to version control Vs docx.

demos look super clean!

I try to support multiple formats on my app: typst, mdx, marp, reveal, latex.

i think it should be possible to add support for quark down too

https://sublimated.com/docs/typst https://sublimated.com/docs/typst/demo/article.typ

The nice thing is that with LLMs using markdown we are getting a nice ecosystem for a universal method for communicating textual information. The negative is that Markdown is starting to look like the https://xkcd.com/927/ cartoon.

how is it for converting streaming api responses from LLM's?