August 22nd, 2024

Quarkdown: Markdown with Superpowers

Quarkdown is an open-source Markdown tool for creating slides, books, and documents from one source. It supports CommonMark, function calls, customizable layouts, and various data formats, with ongoing development.

Read original articleLink Icon
Quarkdown: Markdown with Superpowers

Quarkdown is a versatile Markdown tool that allows users to create various document types, including slides, books, and plain documents, all from a single source code. It adheres to CommonMark and GitHub Flavored Markdown specifications, making it user-friendly for those familiar with Markdown. Quarkdown supports extensive functions from its standard library, enabling users to call functions directly within their Markdown code. It also offers full layout control, allowing for customizable row alignment and text size. Users can include multiple files in a project, import functions from these files, and utilize various data formats, including code and CSV. The tool enhances standard Markdown with features like TeX formulas and intuitive error handling. Quarkdown is open-source and still in development, with stable features for slides but ongoing work for paged documents. Future plans include tutorials and documentation to assist users.

- Quarkdown allows the creation of slides, books, and plain documents from a single source.

- It follows CommonMark and GitHub Flavored Markdown specifications for ease of use.

- Users can call functions and customize layouts directly within their Markdown code.

- The tool supports multi-file projects and various data formats, enhancing its versatility.

- Quarkdown is open-source and in development, with plans for future tutorials and documentation.

Link Icon 17 comments
By @Reason077 - 4 months
Quarkdown could be amazing, but they’re not doing a good job of selling it with such an awful, unusable website.
By @lylejantzi3rd - 4 months
The Latex to Quarkdown comparison in the github README[0] is a much better introduction than the slide show.

Or, maybe I'm just an old and ornery programmer who frequently says in his head "GET TO THE POINT!"

[0]: https://github.com/iamgio/quarkdown?tab=readme-ov-file#compa...

By @remoquete - 4 months
Very interesting. If people keeps creating their own extensions of Markdown it's because there's a need somewhere for a comprehensive markup language. Markdown wasn't invented with documentation in mind, for example, so now we have rST, Asciidoc, Markdoc, Djot, etc. I really wish a powerful standard emerged, though.
By @viraptor - 4 months
Unfortunately the result prevents me from zooming in on mobile, so I can't see the code examples.
By @tcsenpai - 4 months
Each complication over Markdown is utterly interesting to me. Tho I never stick at one due to diffusion
By @knallfrosch - 4 months
Navigate with the Right-Arrow key or by clicking the arrow in the bottom right corner.
By @ivolimmen - 4 months
I like it. It's not complex but you can do complex stuff. It is why I use AsciiDoc. I don't think creating a new (and better) markdown will win hearts... yes it is nice but you need to compete with a lot of attempts to improve it. ... relevant XKCD: https://xkcd.com/927/
By @amelius - 4 months
At the end of each slide animation, the slide seems to jump a few pixels.

I'm on Firefox.

By @hprotagonist - 4 months
but, i have org-mode already!
By @donpdonp - 4 months
this looks very nice though it also is close to typst. a comparison would be interesting.
By @tiffanyh - 4 months
I misread "quark" as "quirk" and thought to myself "please don't bring back IE 'quirk mode'"
By @frizlab - 4 months
No! Markdown is made to be simple. Don’t use it for complex projects. Use properly thought out markup languages for that, like Asciidoc.
By @v3ss0n - 4 months
I guess OP never get why there is markdown in first place. Why another scripting lang inside Markdown which suppose to be readble , natural to write , easy to render.

```

.function {greet}

    to from:

    \*Hello, .to\* from .from!
.greet {world} from:{Giorgio}

```

No Hell No , You don't need that in a markdown-like doc. If you want that just use HTML with js. or MDSvex .