--- title: Markdown is a terrible language | daily.dev description: A critical deep-dive into Markdown's fundamental flaws, covering its ambiguous syntax (multiple ways to write bold/italic), inline HTML security... canonical: https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Markdown is a terrible language | daily.dev og:description: A critical deep-dive into Markdown's fundamental flaws, covering its ambiguous syntax (multiple ways to write bold/italic), inline HTML security... og:url: https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww og:image: https://api.daily.dev/og/posts/Mhemw8eWw.png og:image:alt: Markdown is a terrible language og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Markdown is a terrible language **[Theo - t3․gg](https://daily.dev/sources/t3dotgg)** · 22 min read · 0 upvotes · 0 comments ## Summary A critical deep-dive into Markdown's fundamental flaws, covering its ambiguous syntax (multiple ways to write bold/italic), inline HTML security vulnerabilities including ReDoS and XSS CVEs, context-sensitive grammar issues introduced by footnotes, and the feature creep that turned a simple transliterator into a full compiler. The author argues Markdown has been stretched far beyond its original purpose and advocates for a purpose-built markup language with a proper build system, unambiguous syntax, and well-defined shortcodes instead of continuing to bolt features onto a broken foundation. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Similar posts on daily.dev - [Why the heck are we still using Markdown??](https://daily.dev/posts/why-the-heck-are-we-still-using-markdown--mud109xly) · Hacker News · 0 upvotes · 0 comments - [Making The Case Against Markdown](https://daily.dev/posts/making-the-case-against-markdown-doobxaofv) · Hackaday · 44 upvotes · 4 comments - [Markdown \(Aaron Swartz: The Weblog\)](https://daily.dev/posts/markdown-aaron-swartz-the-weblog--ds2vgoaxp) · Lobsters · 0 upvotes · 0 comments --- Tags: [#html](https://daily.dev/tags/html), [#markdown](https://daily.dev/tags/markdown) [View this post on daily.dev](https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Markdown is a terrible language","url":"https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww"},"datePublished":"2026-04-27T08:59:40.980Z","dateModified":"2026-04-27T08:59:59.334Z","description":"A critical deep-dive into Markdown's fundamental flaws, covering its ambiguous syntax (multiple ways to write bold/italic), inline HTML security...","image":"https://i.ytimg.com/vi/DWcqbPm_Rn4/sddefault.jpg","thumbnailUrl":"https://i.ytimg.com/vi/DWcqbPm_Rn4/sddefault.jpg","isAccessibleForFree":true,"articleSection":"Theo - t3․gg","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Theo - t3․gg","logo":"https://media.daily.dev/image/upload/s--UmX7IyU3--/f_auto/v1704628081/logos/t3dotgg.jpg","url":"https://daily.dev/sources/t3dotgg"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/markdown-is-a-terrible-language-mhemw8eww","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"html,markdown","timeRequired":"PT22M","video":{"@type":"VideoObject","name":"Markdown is a terrible language","description":"A critical deep-dive into Markdown's fundamental flaws, covering its ambiguous syntax (multiple ways to write bold/italic), inline HTML security...","thumbnailUrl":"https://i.ytimg.com/vi/DWcqbPm_Rn4/sddefault.jpg","uploadDate":"2026-04-27T08:59:40.980Z","duration":"PT22M","url":"https://api.daily.dev/r/Mhemw8eWw","embedUrl":"https://www.youtube.com/embed/DWcqbPm_Rn4"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Theo - t3․gg","item":"https://daily.dev/sources/t3dotgg"},{"@type":"ListItem","position":3,"name":"Markdown is a terrible language"}]} ```