Blog 1/3

Leaving corporate after years of pushing for systemic change, and choosing a slower, more personal path — blending documentation, web work, and herbalism into a space that reflects what I value, not just what I know.

To Shiki or not to Shiki, that is the question. The latest Shiki update broke my setup and I had the perfect excuse to try out Expressive Code. But it doesn't come with support for Markdoc. It's custom-component time!

In an effort to simplify my life and workflow, and reduce some costs, I'm moving my blog & domain from Netlify & Namecheap to Cloudflare Pages and the Cloudflare registrar.

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.

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.