Firstly I think this is a super interesting approach to a real problem. I think it offers a lot. I wonder about frustrations around consistency etc though. Have you had any? I have been building a slightly different solution to the same problem. So far I’m pretty happy with the results and I have enough returning users that I think others are too ( https://sdocs.dev/analytics ). I’ve built SmallDocs ( https://sdocs.d…
I really like this idea. The md preview thing is super annoying. However, I was hoping your solution was like a local desktop app thats a dedicated md rendering app, things you've asked for line up in the queue for review. My browser is like a junk drawer, can't be bothered to go hunting in there.
Using Claude Code: The unreasonable effectiveness of HTML
151–160 of 308 posts
Re: Using Claude Code: The unreasonable effectiveness of HTML
#152Earlier quoted context omitted.
Yes that’s the case. And as Anthropic staff, author has an incentive to promote workflows that require an agent to interact with text documents.
HTML is by far simpler than Markdown.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#153My 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…
HTML is super human readable if you stick to a subset of it. It's arguable even more readable. bold italic underline I can never remember how many stars and ticks correspond to what in markdown.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#154My 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?
HTML made by Claude will, by default, be "sleek, modern", with colorful tables, cards, maybe Tailwind for styling. And, of course it will, if you wanted a barebones HTML, you would just have asked for markdown!
So the LLM decided to present some content using 4 cards, and you now want to add new itens. You can't just add new lines of text: you need to copy the whole HTML of the cards. But the LLM used different colors for each card, so now you have the first cards with varying colors and the new cards all the same color as the last card. Now you have to think about colors... etc etc
Re: Using Claude Code: The unreasonable effectiveness of HTML
#155My 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…
The same could be said of any proprietary file format (which HTML is not!) Designers aren't concerned when they create inside a .psd or .ai file.
This feels very similar IMO.
Re: Using Claude Code: The unreasonable effectiveness of HTML
#156My 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…
HTML is super human readable if you stick to a subset of it. It's arguable even more readable. bold italic underline I can never remember how many stars and ticks correspond to what in markdown.
1: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...
2: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...
3: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...
Re: Using Claude Code: The unreasonable effectiveness of HTML
#157Re: Using Claude Code: The unreasonable effectiveness of HTML
#158Re: Using Claude Code: The unreasonable effectiveness of HTML
#159Or, you could do what I did, and process your markdown using Typst. The result is consistent, beautifully formatted documents, generated from your markdown, with mermaid diagrams.