iliana

pure of heart and dumb of ass

computer toucher (derogatory); recreational bureaucrat; longer intro


ktiiy, full-stacked shitpost development engineer, and crow appreciator


get shrdled, idiot


see also:


blog / RSS
iliana.fyi/
email me
iliana@buttslol.net

markdown is such an awful language to learn and use lmao

maybe if i'm feeling particularly masochistic i will research and write up a brief history of markdown and all of the twists and turns that made it awful


You must log in to comment.

in reply to @iliana's post:

I've actively been listening to other functional safety engineering experts talk about their documentation trails and they're very interesting

Markdown is used in conjunction with LaTeX to generate their paper trails, while also leveraging docstrings (if available) in their code and pulling directly from them. Not to mention some of the tagging options used with tools like Obsidian allow a graph of the documentation dependencies. Then again this is all for the sake of making comprehensive paper trails for safety-first codebases.

But also atm I do feel like a vim-head trying to fit markdown into every facet of my life.

i would suggest that a big problem is that the original spec of markdown is "someone thought this was a cool little format to write stuff in" and it was ambiguous and standards proliferated in a way where you can basically only rely on pre, em, and strong working roughly the same across any two things that accept "markdown" (a lot of things will also accept links, headers, blockquote, and at least one kind of code block but possibly not the one you're using; also i imagine some things don't actually render the semantically expected tags for what i called pre, em and strong earlier but just the visuals)

I’d be curious to read the history! There’s so many flavors of it. I think theoretically I’d like it a lot more (easy to remember, still readable in plain text) but it seems to have a lot of weird warts that are exacerbated by everything implementing it differently, or combining it with HTML /CSS badly