Products · Product
Markdown
Raised as a usability problem by 182 people on Hacker News over 19 years (2008–2026), in 148 threads.
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
Every issue, all time, most people first
Hard to remember link syntax order and which brackets to useUnreviewed
20082026- People struggle to remember link syntax order and which brackets to use2026-01-22
- Markdown link syntax is hard to remember, so the commenter keeps forgetting it2026-01-10
- Link syntax [text](href) is confusing and leads to frequent errors2025-02-27
Raw formatting shows in files, requiring an editor preview to readUnreviewed
20082026- Browsers show raw markdown text instead of rendered content when opening a .md file2026-10-22
- Opening a heavy editor and right-clicking to preview a Markdown file is a chore2026-09-04
- Double-clicking .md files shows raw formatting characters instead of rendered text2026-01-10
Line breaks need invisible trailing double spaces that are easy to loseUnreviewed
20082026- Non-obvious syntax: whitespace rules, confusing italics markers, and too many link forms2026-04-04
- Visual line breaks require unnatural trailing double spaces that are invisible and easy to lose2025-09-10
- Needs unnatural double trailing spaces to force a visual line break2025-09-10
Must look up table syntax each time since tables are rarely writtenUnreviewed
20082026- Hand-formatting Markdown tables is tedious, pushing users toward rich text editors2026-04-27
- Creating tables in Markdown is so painful the commenter avoids trying2022-02-14
- Markdown's weird syntax and edge cases make tables and boxes hard to write2022-01-30
Adding images, sketches, tables and links to Markdown is painfulUnreviewed
20082026- Markdown mistakes go unnoticed, so text and images silently disappear2025-08-18
- Markdown with images is hard to read as plaintext, requiring a generated version2024-07-31
- Markdown documents are hard to read and remember information from2024-01-21
Nested ordered and unordered lists are hard to writeUnreviewed
20082026- List formatting in Markdown behaves inconsistently, requiring workarounds to work correctly2023-02-07
- Markdown lacks formatting for table cells and numbered lists in formal documents2020-03-24
- Nested list syntax is error-prone; the writer gets it wrong every time2019-11-06
Underlined headings look like they belong to the following paragraphUnreviewed
20082026- Underlined headings look like they belong to the following paragraph, hard to read2021-01-29
- Indentation and header underlines are annoying and need counting, so they are hard to get right2020-04-04
- Headings look like bullet points, making text harder to follow2017-09-24
Underscore and slash syntax don't produce expected underline or italicsUnreviewed
20082026- Inconsistent syntax for italic and bold, and underline requires HTML tags2025-06-05
- Underscore and slash syntax doesn't produce the underline or italics users expect2016-08-05
- Internal underlines in words break formatting, making Markdown a pain for technical writing2009-12-29
Editor auto-formatting rules are messy and fight the userUnreviewed
20082026- Editor auto-formatting gets its rules in a mess, so the user has to wrestle with it2022-02-15
- Formatting is fickle and unpredictable for users typing input2020-05-18
- Complex formatting needs help text and constant preview checking2015-12-20
Lists break because newline and numbering rules are unintuitiveUnreviewed
20082026- Lists break because newline and numbering rules are unintuitive and hard to learn2022-10-28
- Single newlines don't break lines, which is unintuitive for writers2019-04-25
- Line-break and list rules are counterintuitive and inconsistently implemented across renderers2013-04-26
Broken markup silently becomes plain text, and rendering varies by processorUnreviewed
20082026- Single line breaks are discarded in rendered output, so formatted text looks worse2026-04-04
- Markdown renderers disagree on the same text, so output is unpredictable2026-02-11
- Output rendering changes between processors, and broken markup silently becomes plain text2020-02-14
Markup symbols like backticks and carets are hard to type on non-English layoutsUnreviewed
20082026- Markup symbols like backticks, ^ and ~ are hard to type on non-English keyboard layouts2023-07-20
- Heavy Unicode syntax is impossible for most people to type in ordinary text editors2023-01-20
- Markdown symbols like brackets and slashes are hard to type on some keyboard layouts2020-05-19
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 50 complaints
- Markup symbols break when copied, making the broken spot hard to find2026-10-22
- Changing one character breaks the whole table; adding columns is tedious2026-10-22
- Browsers show raw markdown text instead of rendered content when opening a .md file2026-10-22
- Opening a heavy editor and right-clicking to preview a Markdown file is a chore2026-09-04
- Markdown's HTML-style comments are intolerably unergonomic for writing progress notes2026-08-17
- Creating a new note requires right-clicking a note; no toolbar button for it2026-08-13
- Underspecified syntax makes mixing and matching different tools frustrating for users2026-08-04
- Dozens of incompatible Markdown flavors make basic things hard to figure out2026-06-15
- Math delimiters need doubled backslashes because backslash is also the escape character2026-05-24
- Hand-formatting Markdown tables is tedious, pushing users toward rich text editors2026-04-27
- Non-obvious syntax: whitespace rules, confusing italics markers, and too many link forms2026-04-04
- Users can't remember which asterisk syntax gives italic versus bold, needing a cheat sheet2026-04-04
- Single line breaks are discarded in rendered output, so formatted text looks worse2026-04-04
- Asterisks clutter the editing view and hide the formatted text layout2026-04-04
- Visible asterisk markup clutters bold text when reading and editing elsewhere2026-04-04
- Asterisks disappear when bold is rendered, making editing confusing2026-04-04
- Pipe syntax is painful to write and hard to maintain once cells have more than a few words2026-02-21
- Native conversion breaks much of the formatting when exporting Notes to Markdown2026-02-16
- Markdown renderers disagree on the same text, so output is unpredictable2026-02-11
- Markdown lacks layout control, and adding it leads to LaTeX, which is tiresome and unproductive2026-02-08
- People struggle to remember link syntax order and which brackets to use2026-01-22
- Existing viewers only render single files, so browsing related documents is hard2026-01-15
- Markdown link syntax is hard to remember, so the commenter keeps forgetting it2026-01-10
- Double-clicking .md files shows raw formatting characters instead of rendered text2026-01-10
- Markdown files show raw formatting characters because few viewers exist; readers must open an editor preview2025-12-23
- New users find Markdown tricky, so pasted code is hard to read unformatted2025-11-30
- Fiddling with markup syntax interrupts the writer's flow2025-11-23
- Needs unnatural double trailing spaces to force a visual line break2025-09-10
- Visual line breaks require unnatural trailing double spaces that are invisible and easy to lose2025-09-10
- Markdown mistakes go unnoticed, so text and images silently disappear2025-08-18
- Small syntax mistakes cause partially broken formatting or silently lost content2025-08-18
- Emphasis markers inconsistently apply mid-word, making it hard to form a mental model2025-08-18
- Raw HTML tables hurt readability, so teammates need preview mode to read them2025-06-05
- Few apps render Markdown, so files show raw formatting codes2025-06-05
- Inconsistent syntax for italic and bold, and underline requires HTML tags2025-06-05
- Raw markdown hides formatting and is hard to read while writing, needing constant preview switching2025-04-23
- Can't tell whether Mermaid diagrams will render in a given Markdown editor or renderer2025-02-27
- Link syntax [text](href) is confusing and leads to frequent errors2025-02-27
- Can't find a simple fast Markdown viewer; must use editors with poor viewing2025-02-26
- Formatting isn't visible while writing, only after rendering2025-02-26
- Users must remember syntax and can't see formatting while writing2025-02-26
- Few plain Markdown viewers exist for reading rendered files, unlike PDF viewers2025-02-26
- With JavaScript off, links show as raw Markdown and must be copied manually2025-02-11
- Markdown has many incompatible flavours and inconsistent support across tools2025-02-06
- Clicking a footnote jumps far away with no way back, forcing users to hunt for their place2025-01-05
- Non-engineers must learn code-like syntax and jargon just to format text2024-12-03
- Markdown's syntax clutters content, so writers must deal with markup noise2024-08-23
- Backspace unexpectedly reformats half the document2024-08-15
- Users must switch between view mode and edit mode, and raw markdown clutters the document2024-08-15
- Putting long URLs inline makes the text hard to read, so the author uses footnote-style links instead2024-08-15