4 ms·

Is this sarcasm? or are we coming back full circle unintentionally?

nicoburns 2y ago
It's not sarcasm. HTML is and always has been a decent format for hand-authoring documents. It's not as nice to use as markdown, but it does support more advanced use cases like coloured text. And if you want an "archival" format that will stand the test of time it's pretty good (so long as your text encoding is readable, HTML will be).
- cma 2y ago
  versus markdown it is ungreppable with all the escape codes/entities, then you have to use special tooling for search.
  - oneeyedpigeon 2y ago
    Avoid character entities—store your HTML files as UTF-8 and just embed everything.
    - deleted 2y ago
      [deleted]
    - cma 2y ago
      I guess that mostly works but lots of my notes have <>'s. I guess <code> covers most of that
- colonial 2y ago
  I agree with you, but I will say that Markdown (or at least, all the major "standards" for it) support interleaving HTML both inline and at the block level. Unless you are writing a very bombastic document or want to avoid a rendering step, I'd argue that you'd be best served by just writing CommonMark with embedded HTML.
  - oneeyedpigeon 2y ago
    I'd argue that, at that point, you might as well write HTML. I find it easier to work with one format at a time rather than two intermixed and a typical Markdown document is barely more readable than its equivalent HTML document, while the latter gives you a lot more flexibility and semantic accuracy.
ajxs 2y ago
When I created the SSG I use for my blog, I tested a bunch of different markup formats for the article content, but in the end I settled on plain-old raw HTML. Over the years, I've needed to render so many different specific visual elements in the blog entries that if I wasn't actually using raw HTML, I'd probably be using raw HTML snippets all over the place anyway. For another medium I might choose a different markup format, but when it comes to writing content for the web, with HTML I know exactly what I'm getting every time.

It's not sarcasm. HTML is and always has been a decent format for hand-authoring documents. It's not as nice to use as markdown, but it does support more advanced use cases like coloured text. And if you want an "archival" format that will stand the test of time it's pretty good (so long as your text encoding is readable, HTML will be).

cma 2y ago
versus markdown it is ungreppable with all the escape codes/entities, then you have to use special tooling for search.
- oneeyedpigeon 2y ago
  Avoid character entities—store your HTML files as UTF-8 and just embed everything.
  - deleted 2y ago
    [deleted]
  - cma 2y ago
    I guess that mostly works but lots of my notes have <>'s. I guess <code> covers most of that
colonial 2y ago
I agree with you, but I will say that Markdown (or at least, all the major "standards" for it) support interleaving HTML both inline and at the block level. Unless you are writing a very bombastic document or want to avoid a rendering step, I'd argue that you'd be best served by just writing CommonMark with embedded HTML.
- oneeyedpigeon 2y ago
  I'd argue that, at that point, you might as well write HTML. I find it easier to work with one format at a time rather than two intermixed and a typical Markdown document is barely more readable than its equivalent HTML document, while the latter gives you a lot more flexibility and semantic accuracy.

ajxs 2y ago

When I created the SSG I use for my blog, I tested a bunch of different markup formats for the article content, but in the end I settled on plain-old raw HTML. Over the years, I've needed to render so many different specific visual elements in the blog entries that if I wasn't actually using raw HTML, I'd probably be using raw HTML snippets all over the place anyway. For another medium I might choose a different markup format, but when it comes to writing content for the web, with HTML I know exactly what I'm getting every time.