OK, so, this is only tangential to the purpose of this community, but still. The concept of a PKMS has tossed me into a wider interest in storing the content of a document entirely in plaintext with nothing but a markup language, and then formatting that content from there (often with PanDoc). Nothing frustrates me more lately than the idea of stuff that could be in text files yet isn’t, because text files are rad as hell and computers actually understand them.

Confession: It’s a TTRPG rulebook because of course it’s a TTRPG rulebook. Of course the traditional method of making something that that is, y’know, Adobe Acrobat, but starting with something like that means that converting to any other format is just harder than it needs to be.

Obviously a PKMS like Obsidian isn’t really suited for longform, heavily hierarchical content like this. You used to be able to use nested YAML to hack a chapter / subchapter system together but no longer, and it was never a very good idea- if anything Obsidian intentionally resists attempts at hierarchy. LaTeX is awesome but none of the people who use LaTeX know how to document / tutorialize it in a sane way and it’s community consists entirely of mathematicians and technical writers. Seems like an astoundingly useful tool that goes woefully under-utilized.

My idea right now is to try using the DocUtils. It’s markup language ReStructure is explicitly hierarchical and, bonus points, ReStructure is used by Project Gutenberg for it’s epub tools.

Any other ideas? Am I being a bit of an idiot?

Edit:

I got what I was looking for. It’s AsciiDoc. Kind of a holy grail tech thing for me.

  • AsciiDoc does indeed look rad as hell, thanks for bringing it to my attention! I’m going to take a look into it :)

    As for your original question though, I would just abuse headings and heading sizes. I’d use the biggest heading size for chapters, the next one down for subchapters, etc. I got this idea from Google Docs, as headings are what it pulls from when you ask it to make a table of contents. I don’t think Obsidian will do that, but I’ve never tried to use Obsidian to outline anything so it’s entirely possible Obsidian would do something similar for you.

    • Oh, that’s totally what I’ve been doing, but since Obsidian is Markdown-based you can only do so much with it. I could definitely use Google Docs to do something similar, but like I said in this post I’d like to have it all written out in a plaintext file because then, I could turn it into other stuff like a PDF, an EPUB, even a simple website without too much trouble.