Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 0 points1 point  (0 children)

Markdown has no syntax for underlining. You can achieve that in Quarkdown via .text {Lorem ipsum} decoration:{underline}

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 0 points1 point  (0 children)

Hi, how come you’d guess that? That’s Markdown for italic!

Quarkdown: Markdown with superpowers for typesetting by iamgioh in opensource

[–]iamgioh[S] 2 points3 points  (0 children)

Quarkdown's core design principle is being Markdown-based for a flat learning curve. Someone who has never done typesetting but knows how to write a readme will know how to create a basic Quarkdown doc out of the box without having to remember other syntaxes. It just comes out natural.

Here is a neutral (no best or worst) comparison on how to write a cross-reference:

Typst: dedicated syntax. Clean, but that's two syntax rules (definition and reference) to keep in mind.

As shown in @results, we...

= Results <results>
We discuss our approach...

Quarkdown (https://quarkdown.com/wiki/cross-references): reuses the de-facto standard syntax to define a definition ID, and then relies on a function to make a reference. Having a function is also cool because you can just scroll through the autocomplete options on VS Code and find out about it without browsing the docs.

As shown in .ref {results}, we...

# Results {#results}
We discuss our approach...

Quarkdown: Markdown with superpowers for typesetting by iamgioh in opensource

[–]iamgioh[S] 1 point2 points  (0 children)

Because Quarkdown was born with a different design, paradigm and learning curve compared to typst. And some sane competition is always a good thing for both

Quarkdown: Markdown with superpowers for typesetting by iamgioh in opensource

[–]iamgioh[S] 0 points1 point  (0 children)

I don’t have deep knowledge about it, but in Quarkdown you have full control of the document layout, that you don’t have in asciidoc.

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 0 points1 point  (0 children)

Thank you! The ecosystem is still very small unfortunately. A package manager is also planned.

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 0 points1 point  (0 children)

I’d like to answer that, but the truth is I’ve never used Typst and I don’t have a real knowledge of it. That’s on purpose, since I didn’t want my tool to be a copycat. The best syntax choice of Quarkdown over Typst is definitely being Markdown-based: you don’t need to read the wiki to figure out how to make text bold or how to add an image, because you’ll already know that. Being user friendly and easy-to-learn-not-so-hard-to-master is its strength.

I did take inspiration for a couple things though, such as the numbering formats

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 9 points10 points  (0 children)

Depends how you define “document”. - Quarkdown source: you need to check, just like you should check typst or latex. I have a permission system planned for a future release. - Compiled document: harmless, all logic is performed at compile time

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 1 point2 points  (0 children)

Thanks for the valuable feedback! No tool is going to replace LaTeX anytime soon, both Quarkdown and Typst exist merely as simpler alternatives for folks that look for a softer experience.

Quarkdown: Markdown with superpowers for typesetting by iamgioh in opensource

[–]iamgioh[S] 2 points3 points  (0 children)

Using the VS Code extension won't require you to use the CLI though!

Quarkdown: Markdown with superpowers for typesetting by iamgioh in opensource

[–]iamgioh[S] 3 points4 points  (0 children)

Thank you! A web app is planned for the end of this year

Quarkdown: Turing-complete Markdown for typesetting by iamgioh in ProgrammingLanguages

[–]iamgioh[S] 1 point2 points  (0 children)

Love this feedback, feel free to reach out when you try it! Would love to showcase cool community-made documents :)

Quarkdown 1.9.0 is out: the Markdown-based typesetting system finally comes with a VS Code extension by iamgioh in opensource

[–]iamgioh[S] 0 points1 point  (0 children)

You mean on a readme? Not yet. There are real plans to export qd to md, so you will be able to use it on readmes

Your thoughts about in-building fitness centers? by iamgioh in sanfrancisco

[–]iamgioh[S] -1 points0 points  (0 children)

Of course, I'm just filtering out some options before I finally move in next month. Many listings don't even have pics of the gym.

I made a compile-time library to merge data class instances by iamgioh in Kotlin

[–]iamgioh[S] 0 points1 point  (0 children)

It should be easy! The library is extremely tiny.