I'm fairly new to all this, but my understanding is that Markdown is great for a few reasons: It's just plain text, so no vendor lock-in and you can ripgrep/fzf/grep through it Lives happily in git repos with proper diffs LLMs speak it natively - they output Markdown, they understand Markdown input Way easier for agents to parse than PDFs (which are binary, layout-focused, tables turn to mush) Can do tables (at least…
> What it can't do (as far as I understand): complex layouts, precise typography, embedded binary content, anything that needs pixel-perfect rendering. Am I missing anything? What are the other limitations I should know about? Multi-level lists, annoyingly, get rendered as code at the deeper levels because of the 4+ spaces from the beginning of the line. This is a serious and major drawback of markdown, making it goo…
Not so. You just need to be principled with your indentation, adding four spaces or one tab for every level of nesting.
1. Here is a thing.
- See, it works.
Nothing is amiss.
2. If you want to align everything…
- Then it looks like this.
Then it doesn’t seem so weird.
(You can leave or remove the two spaces of HN code formatting; zero to three spaces don’t matter.)