bloggy is out fr (also now yells at your bad markdown)Published at 2025-04-14 (18:38:40)
bloggy is out. frfr. it's on npm. like you can actually npm install -g bloggy-md now.
and then run bloggy and it does the thing. the markdown thing. into HTML. you get it.
👉 check it on guthib
📦 and heres the npm page
what even is bloggy?
if you forgot (or this is your first time here), bloggy is my little cli tool that turns markdown files into html pages using a template file and some magic comments like:
<!-- [BLOGGY::TITLE] -->
<!-- [BLOGGY::DESCRIPTION] -->
<!-- [BLOGGY::CONTENT] -->
<!-- [BLOGGY::COLOR] -->
<!-- [BLOGGY::DATE] -->
<!-- [BLOGGY::TIME] -->
| tag | what it does |
|---|---|
<!-- [BLOGGY::TITLE] --> |
gets replaced with the post's title |
<!-- [BLOGGY::DESCRIPTION] --> |
the posts description, most useful for seo tags |
<!-- [BLOGGY::COLOR] --> |
the post's accent color (you can use it as the page's theme-color for seo as well) |
<!-- [BLOGGY::CONTENT] --> |
this is where the html-ified markdown goes |
<!-- [BLOGGY::DATE] --> |
gets replaced by the current date |
<!-- [BLOGGY::TIME] --> |
gets replaced by the current time |
what's new?
since the last post, ive added a bunch of cool stuff to make bloggy slightly less jank and more usable, like:
markdown validation
yes. it yells at you now. but like, helpfully. here’s an example of what it catches:
⛔ stuff wrong:
• empty link target for "[This link is broken]()". this is missing a url!
⚠ bad practice:
• found raw html tags in markdown: <div>
you can turn this off with --no-validate, or just --no-warns / --no-errors. or do it permanently in config.yaml.
watch mode (--watch / -w)
bloggy now watches your markdown file for changes and regenerates the html insantly.
bloggy markdown/post.md -w
you’ll see output like:
👀 watching for changes to markdown/04-13-2025.md...
✓ /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
✓ /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
✓ /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
✓ /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
✓ /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
fancy-er cli
its so much cooler now fr, and it even has colors now, thanks to colorette! for example using it on the markdown file for this page outputs:
$ bloggy markdown/04-13-2025.md
⛔ stuff wrong:
• empty link target for "[This link is broken]()". this is missing a url!
⚠ bad practice:
• found raw html tags in markdown: <div>
Notes:
📝 bloggy will still convert this to html, just some things will likely be broken.
you can disable this with --no-warns and --no-errors, or just --no-validate to disable both.
you can also do this same thing in the config.yaml file if you want, itll do the same thing
---------------------
📝 maked: 04-13-2025.html (⛔ 1 | ⚠1)
---------------------
📝 title: bloggy is out fr (also now yells at your bad markdown)
📎 desc: this is the update post for bloggy because omg it’s out now
📂 saved to: /home/unium/Projects/personal/portfolio-site/gh/blog/04-13-2025.html
$ # so cool, right?
now, this is obviously missing colours but come on :(
final thoughts!
even though, yeah, this is kinda of jank, and i wouldn't recommend using this over proper static site generators like hugo, astro or jekyll, i still like it, its nice, its simple, and it just works (for me at least!) :)
so, if you want to tinker around with this, go download it with npm install -g bloggy-md!