Quarkdown uses actual functions that return values, they aren't macros.
As for source readability, it's possible to define functions in a separate .qd file and import it via .include {myfile.qd}
The wiki explains Quarkdown’s concept of subdocuments. A subdocument gets created when linking to another Quarkdown/Markdown file and populates a graph. Subdocuments inherit the linker’s properties but are then independent sandboxes that get compiled independently.
A cross-subdocument cross-reference is such a niche use case that I don’t feel like it should break this design choice.
I was just reflecting on what I saw/thought! But sure, take it as a compliment, the website and branding are amazing, I'm (positively) jealous of how good they reflect on the product, congrats.
I think that's an interesting idea, but you hit the landing page and there's loads of syntax thrown in your face and you're like, man, I need to learn a lot.
But I think this kind of brings up another problem, which is that you can choose not to use stuff if you're writing, but if you're reading other people's docs or editing them, then you need to know all the syntax they use. Most OSS projects with markdown docs today, anyone can open an MR to improve them.
reply