Earlier quoted context omitted.
You have been authoring HTML by hand for decades. Not every SWE is a FE dev.
Most front end devs can’t get HTML right either.
Using Claude Code: The unreasonable effectiveness of HTML
171–180 of 308 posts
Re: Using Claude Code: The unreasonable effectiveness of HTML
#172I moved from Markdown to JSON for all spec writing about 9 months ago. Although not HTML, it still has the same benefits. Claude and the other models are just so much more reliable in a structured format like JSON/HTML/XML. The most important thing is that I can run static analysis on a structured format. This is important even for my spec documents. I can write data fields and have static analysis analyze it. For ex…
I think this is super interesting, but i think you and the OP is talking about two different problems: presenting text to end users and structuring text for agents
The real change is in generation side, and now the spec docs are LLM generated JSON based on other spec docs or human prompts. LLMs seem to write JSON better than Markdown or YAML, if you tell it to follow a schema.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#173My concern here is that by gravitating to HTML you lose the ability for a human (you!) to easily co-author the document with the LLM. If it’s just an explainer for your consumption, that’s not a concern - but if it’s a spec sheet for something more complex, I deeply value being able to dive in and edit what is produced for me. With a HTML doc it is much harder to do that than with MD. Now of course you could just rep…
I’ve started using HTML for reports recently. But I always use a markdown file as an intermediate and tell the LLM to generate a fancier version of it with SVG for graphs/pictures based on tables in the markdown.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#174My concern here is that by gravitating to HTML you lose the ability for a human (you!) to easily co-author the document with the LLM. If it’s just an explainer for your consumption, that’s not a concern - but if it’s a spec sheet for something more complex, I deeply value being able to dive in and edit what is produced for me. With a HTML doc it is much harder to do that than with MD. Now of course you could just rep…
Is HTML really that much worse to edit than MD?
Re: Using Claude Code: The unreasonable effectiveness of HTML
#175When exploring a new idea or tool, my go to prompt is ``` In a single index.html, no dependencies, sparse styling, create an app that ``` Even before AI, it's how I built small tools, and there's something lovely about being able to email my friends the tool, and tell them "If you want to make a change, toss it to your LLM!"
My manager does this and with a straight face comes to me after with it and goes “put this in production” and wonders why it takes more than 5 minutes. I absolutely hate the absolute rot these tools have caused to people’s brains.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#176My concern here is that by gravitating to HTML you lose the ability for a human (you!) to easily co-author the document with the LLM. If it’s just an explainer for your consumption, that’s not a concern - but if it’s a spec sheet for something more complex, I deeply value being able to dive in and edit what is produced for me. With a HTML doc it is much harder to do that than with MD. Now of course you could just rep…
On a serious note some kind of rich Markdown would definitely help.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#177My concern here is that by gravitating to HTML you lose the ability for a human (you!) to easily co-author the document with the LLM. If it’s just an explainer for your consumption, that’s not a concern - but if it’s a spec sheet for something more complex, I deeply value being able to dive in and edit what is produced for me. With a HTML doc it is much harder to do that than with MD. Now of course you could just rep…
Re: Using Claude Code: The unreasonable effectiveness of HTML
#178My concern here is that by gravitating to HTML you lose the ability for a human (you!) to easily co-author the document with the LLM. If it’s just an explainer for your consumption, that’s not a concern - but if it’s a spec sheet for something more complex, I deeply value being able to dive in and edit what is produced for me. With a HTML doc it is much harder to do that than with MD. Now of course you could just rep…
We have been authoring HTML by hand for decades with ease. Text editors are very good at it, and many have commands to auto-wrap, auto-close etc. Reading and writing is simple.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#179Earlier quoted context omitted.
I actually think there is a second level to this. Yes HTML will get you most anywhere, but I found that letting the LLM define its own language is also unreasonably effective. Currently working on a dumb little mobile game with isometric view and sound: - told codex to write a tool that lets its place blocks in a prepared three.js document and have chromium dev tools take a screenshot. It made up a little JSON struct…
[flagged]
Re: Using Claude Code: The unreasonable effectiveness of HTML
#180- work text / human or mixed input: markdown, plain text
- fancy looks / interaction: html
avoid creating problems, try solving them instead. and don't start futile smoke campaigns.