The Astro Markdoc integration will not work for me as long as it doesn't use the `.md` extension. The Astro experience with plain ol' Markdown and my Obsidian is so good I can't imagine sacrificing it for anything less capable.
Hi! I'm Anca,
a superkitty majordomo, herbalist in training,
full-stack dev in a tech writer gig, and other things.
This is my digital garden. Enjoy your stay.
Anca's Digital Garden
Astro Markdoc doesn't have feature parity with Markdown yet. Here are my Astro Markdoc solutions for linked headings, table of contents, external links in the Markdoc body, Shiki code blocks with a custom theme, and more.
Converting the blog to Astro was a more significant win than initially expected. A bit more time with the documentation of Astro, Obsidian, and Markdoc, and things went 100% green. On all counts.
I've struggled to keep my blog up-to-date in the past few years. The reasons for that are many. They say it's not a good idea to convert a hobby into a job because you'll end up not liking your hobby. While that is partially true, my main reasons were technological in nature. Round hole, square peg type of thing. By switching to Astro with Markdoc, I hope to solve my problems.
Sometimes local servers get naughty and fail to exit with a signal. They end up occupying a port, and that isn't very pleasant. Here's how to kill them using lsof.