More documentation needed

[lxwulf]

Hello there 👋,

I'm very interested in this project! I want to give this a try, but the lack of documentation makes it hard, at least for me. Likewise, I may miss something. 🤷‍♂️

What I have in mind is something like a cheat sheet or of course something like this with more details.

I know there is demo code from the demo website, but still it's hard to filter out what is needed for my idea or document.

I may be wrong with the expectation of this project, but I wanted to replace my momentary working tools with quarkdown.

PS: What about export to PDF?

Else great idea and work! 👏

[iamgio]

Hi @lxwulf and thank you for your appreciation towards the project! As Quarkdown gets closer to a stable version commit by commit, I myself notice how important it is to have documentation available, and that's why doing something like what you mentioned is at the top of my list.

However, even if there is not a "unified" documentation yet, here are some useful resources:

• README for installation, cli options and theme list;
• Demo for some useful snippets;
• Wiki which is currently work in progress, and currently focuses on what the demo doesn't cover;
• stdlib: the whole codebase is fully documented, including the standard library, which is currently the only library available. It's not huge, so you can easily find all the available functions and their documentation from there;
• FullPipelineTest: this test module tests the correct output of full Quarkdown programs, so you can find useful examples here.

Though it's obviously not the optimal solution, combining these resources will provide everything you need to use Quarkdown.

I'm keeping this issue open until the wiki reaches a better state. It won't cover every function from the stdlib though, as that would be quite inefficient. It is planned (not too soon though) to add a documentation-to-html exporter tool like many programming languages do.

And (spoiler!) Quarkdown could get 'Documentation' as a fourth document type, along with plain, slides and paged. This would allow to build the official documentation using Quarkdown itself - pretty cool heh.

That said, the GitHub wiki will expand and is going to be the main resource to learn Quarkdown from, at least for a while.

PS: What about export to PDF?

It's planned too, however very far in the future. It's better to perfect the HTML experience before adding new targets. You can of course convert the HTML output to PDF via your browser.

• Paged documents are print-ready;
• Follow these instructions to losslessly save slides to PDF.