- I don't need key commands. What you call clunky I call orders of magnitude more ergonomic.
- Keep in mind things like _italic_ __bold__ and `code` "just work" on mobile.
- Code blocks.
- The document isn't formatting for me while I am typing on it.
- I don't need to type it in your shitty/slow/buggy web editor, I can copy/paste it from my text editor with zero formatting errors.
- I don't care about tables.
- I don't care about type faces or font height.
- I don't care about margins or page breaks, it will never be printed.
- I want to write in monospaced text 100% of the time.
- Hyper links and image links are trivial to add.
- A table of contents is trivial to add.
Confluence for example is the exact opposite of the doc writing experience I want.
Markdown is essentially the perfect balance between quick writing and good enough reading, with no mouse interactions and a standard enough interface for all the places I want to use it (internal docs, GitHub issues, online notes, code review, etc).