2
submitted 1 year ago* (last edited 1 year ago) by Mummelpuffin@beehaw.org to c/pkms

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.

you are viewing a single comment's thread
view the rest of the comments
[-] Emotional_Series7814@kbin.melroy.org 2 points 1 year ago* (last edited 1 year ago)

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.

this post was submitted on 18 Oct 2023
2 points (100.0% liked)

Personal Knowledge Management Systems (PKMS)

520 readers
1 users here now

A place for people to discuss Personal Knowledge Management Systems (PKMS) such as "Building a Second Brain" (BASB), Obsidian, and more.

founded 2 years ago
MODERATORS