{"componentChunkName":"component---src-templates-blog-post-js","path":"/markdown-for-agents-html-for-humans/","result":{"data":{"site":{"siteMetadata":{"title":"Catwomaniya"}},"mdx":{"id":"7ec6a5c8-e7a4-5e60-8152-417d29acb44b","excerpt":"Markdown is fine. HTML is better. I've been writing in Markdown for sometime now. It's portable, easy to edit, agents love it. But at some point it started…","body":"function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\n\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\n\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n\n/* @jsx mdx */\nvar _frontmatter = {\n  \"title\": \"Markdown was built for agents. HTML is built for humans.\",\n  \"date\": \"2026-05-13\",\n  \"description\": \"The format that changed how I think about agentic workflows\"\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n      props = _objectWithoutProperties(_ref, [\"components\"]);\n\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h2\", null, \"Markdown is fine. HTML is better.\"), mdx(\"p\", null, \"I\\u2019ve been writing in Markdown for sometime now. It\\u2019s portable, easy to edit, agents love it.\"), mdx(\"p\", null, \"But at some point it started feeling like a limitation.\"), mdx(\"p\", null, \"You can\\u2019t show color. Can\\u2019t really do diagrams. Can\\u2019t make something someone else actually wants to read. Past 100 lines, I check out, its a lot of text overload and most of the times visuals are better.\"), mdx(\"p\", null, \"So I switched to HTML after seeing this post \", mdx(\"a\", _extends({\n    parentName: \"p\"\n  }, {\n    \"href\": \"https://x.com/trq212/status/2052809885763747935\"\n  }), \"on X\"), \". \"), mdx(\"h2\", null, \"What HTML actually does that Markdown can\\u2019t\"), mdx(\"p\", null, \"HTML isn\\u2019t just \\u201Cfancier text.\\u201D It\\u2019s a completely different surface.\"), mdx(\"p\", null, \"Tables. SVGs. Color. Sliders. Clickable elements. Layouts that breathe. Diagrams that don\\u2019t look like they were drawn by a drunk robot.\"), mdx(\"p\", null, \"Basically anything you\\u2019d want to show or explain someone \\u2014 you can do it properly, cos just reading large text is daunting, and sometimes not the best way to understand things.\"), mdx(\"p\", null, \"Yes you can create agentic workflows now but to be able to review, understand and course-correct what Claude produces, HTML makes that review actually happen.\"), mdx(\"h2\", null, \"How I use it\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Product specs\"), \" - Instead of a 200-line markdown doc nobody reads - ask for an HTML spec. Add mockups, data flow diagrams, key decisions with tradeoffs. Share the link. People will actually open it.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Content planning\"), \" - Drop your goals, audience, and a few reference pieces. Ask Claude to build a content plan as an HTML dashboard \\u2014 calendar view, content pillars, distribution breakdown. Way easier to review than a table in Markdown.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Slide decks\"), \" -  Stop wrestling with Slides for your weekly update or meeting prep. Describe what you want \\u2014 metrics, decisions needed, what shipped - and ask Claude to build it as an HTML slide deck. It pulls in your actual numbers, adds charts, keeps it tight.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Exploring directions before you commit\"), \" -  Ask Claude to generate 4-5 different approaches to something \\u2014 positioning, onboarding flow, pricing structure \\u2014 side by side in one HTML file. Label the tradeoffs. Pick the direction. Move fast.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Custom editors\"), \" - This one\\u2019s underrated. Need to reprioritize your roadmap? Ask Claude to make a drag-and-drop kanban in HTML. Tweaking a prompt? Ask for a side-by-side live preview editor. The trick: always add a \\u201Ccopy as JSON\\u201D or \\u201Ccopy as prompt\\u201D button so you can pipe it back into the next step.\"), mdx(\"h2\", null, \"It\\u2019s not just about looks\"), mdx(\"p\", null, \"You don\\u2019t need a fancy prompt or a special setup for this.\"), mdx(\"p\", null, \"Just ask for \\u201Can HTML file\\u201D instead of a doc.\"), mdx(\"p\", null, \"The real shift is realizing that the format you use changes how you think about the output \\u2014 and how much you actually use it.\"), mdx(\"p\", null, \"Markdown is for agents talking to agents.\"), mdx(\"p\", null, \"HTML is for agents talking to humans.\"), mdx(\"p\", null, \"(And you\\u2019re still human. For now :P)\"));\n}\n;\nMDXContent.isMDXComponent = true;","frontmatter":{"title":"Markdown was built for agents. HTML is built for humans.","date":"May 13, 2026","description":"The format that changed how I think about agentic workflows"}}},"pageContext":{"slug":"/markdown-for-agents-html-for-humans/","previous":{"fields":{"collection":"blog","slug":"/stop-overthinking-vpns/"},"frontmatter":{"title":"stop overthinking VPNs. just build your own."}},"next":null}}}