News for hackers. Stuff that matters.
Re:Quarkdown: A modern Markdown-based typesetting system by rTX5CMRXIfFG on Tuesday June 03, 2025 @08:10AM (#44169098)
You know what, while you're at it, I might as well bring it up. How about XML?

I haven't really tried writing large pieces of text in it but I am already seriously considering. All other alternatives are too complicated and have a learning curve that gets in the way of writing itself. With XML, I'd be able to define my own tags and run them by a parser later on to auto-generate indexable footnotes, and create my own ways of structuring text besides the usual ones (chapters, sections, etcetera). Has anyone tried this approach?

Re:Quarkdown: A modern Markdown-based typesetting system by rmnclmnt on Tuesday June 03, 2025 @08:15AM (#44169138)
Basically DocBook?
Re:Quarkdown: A modern Markdown-based typesetting system by drob518 on Tuesday June 03, 2025 @09:27AM (#44169873)
Exactly. Seems like we already invented that but it didn’t really catch fire.
Re:Quarkdown: A modern Markdown-based typesetting system by rmnclmnt on Tuesday June 03, 2025 @04:33PM (#44174407)
Yeah last time I touched it was during an internship 15 years ago, the few memories I recall were not enjoyment at all (however I was using LaTeX everywhere at the time).

Writing documentation as XML is powerful but not enjoyable at all I guess

Re:Quarkdown: A modern Markdown-based typesetting system by andrewd18 on Tuesday June 03, 2025 @08:26AM (#44169236)
Professional tech writer here: We use GitHub and a tool called OxygenXML to write docs-as-code in an XML DTD called "DITA". It's a hefty IBM invention from the early aughts, but it covers every use case I've thrown at it, from small documentation sets to multi-thousand-page monsters. Supports PDF, HTML, Word, and many other output types.
Re:Quarkdown: A modern Markdown-based typesetting system by starkparker on Tuesday June 03, 2025 @10:56AM (#44170811)
DITA's so great at everything _except contributions from non-tech writers_ that half of my career has involved migrating tech writing stacks that use it to Markdown/SSGs in git repos.

DITA's benefits require a certain scale that most tech companies never achieve. And the Open Toolkit is a nightmare piece of software.

Re:Quarkdown: A modern Markdown-based typesetting system by andrewd18 on Tuesday June 03, 2025 @06:13PM (#44175357)
Agreed, and we use Markdown where we can. But inevitably some product manager comes along and demands tables inside tables or embedded reuse of content... and it's back to DITA.

OxygenXML makes the OT much more manageable. I haven't had to touch an OT XSL transform in a few years now. Worth every penny.

Re:Quarkdown: A modern Markdown-based typesetting system by dgb23 on Tuesday June 03, 2025 @09:44AM (#44170080)
There's also a standard to turn XML into HTML via XSLT.
Re:Quarkdown: A modern Markdown-based typesetting system by davidpapermill on Tuesday June 03, 2025 @11:01AM (#44170848)
We're doing something similar at Papermill [1]

We're defining a new document language in XML called "Press". It really feels like this is the area where XML shines. We have custom tags and components, easily defined within the document (or separated into different files). We intend to open source the language - we're not rolling out the typesetting API until later this month.

We looked at markdown extensions. I checked with our researcher and he did take a look at Quarkdown and a bunch of others. His first reaction was to compare it to typst [2] and also had some difficulty getting Quarkdown running on his machine.

We like what typst has done, but Papermill is more focused on "design-first" - supporting more general designs - and automation.

[1] https://papermill.io

[2] https://typst.app/

Re:Quarkdown: A modern Markdown-based typesetting system by schaefer on Tuesday June 03, 2025 @11:44AM (#44171277)
I gave your splash page a look: no docs, no examples, no screenshots.

Your "free trial" is behind a sign-up wall. and I left.

Re:Quarkdown: A modern Markdown-based typesetting system by davidpapermill on Tuesday June 03, 2025 @01:13PM (#44172288)
Thanks for the feedback. Yep - we've yet to update the website. It's a waitlist, we're not launched yet. Absolutely fair criticism. It'll be updated in the next few weeks!
Re:Quarkdown: A modern Markdown-based typesetting system by schaefer on Wednesday June 04, 2025 @02:26PM (#44183897)
That's fair! I'll check back in a few weeks.
Re:Quarkdown: A modern Markdown-based typesetting system by tempfile on Tuesday June 03, 2025 @11:23AM (#44171058)
I have been thinking about this seriously myself. Not with a specific existing schema like DocBook, but with a custom schema (defined by me) that I then compile to standard schemas, like DocBook or HTML.

This seems extensible to the degree that I want (i.e. semantically rich enough that you can conceivably hang any application from it). But I just can't bring myself to write in XML syntax, especially for maths.