docs: overhaul for eventual libstd vexide

astro.config.mjs

@@ -14,11 +14,13 @@ import { transformerTitle } from "@rudeigerc/shiki-transformer-title";
 
 import cloudflare from '@astrojs/cloudflare';
 
+import mdx from '@astrojs/mdx';
+
 // https://astro.build/config
 export default defineConfig({
   site: "https://vexide.dev",
   trailingSlash: "always",
-  integrations: [sitemap(), svelte(), markdown()],
+  integrations: [sitemap(), svelte(), markdown(), mdx()],
 
   markdown: {
     rehypePlugins: [

package.json

@@ -14,24 +14,32 @@
 	"dependencies": {
 		"@astrojs/check": "^0.9.4",
 		"@astrojs/cloudflare": "^12.2.3",
+		"@astrojs/mdx": "^4.3.8",
 		"@astrojs/sitemap": "^3.2.1",
 		"@astrojs/svelte": "^7.0.5",
 		"@rudeigerc/shiki-transformer-title": "^0.1.0",
 		"@shikijs/transformers": "^1.29.2",
+		"@types/hast": "^3.0.4",
 		"astro": "^5.4.2",
 		"flexsearch": "^0.7.43",
 		"fuzzysort": "^2.0.4",
+		"hast": "^1.0.0",
 		"hast-util-from-html": "^2.0.3",
+		"hast-util-select": "^6.0.4",
+		"hast-util-to-string": "^3.0.1",
+		"hastscript": "^9.0.1",
 		"prettier": "^3.5.3",
 		"prettier-plugin-astro": "^0.12.3",
 		"prettier-plugin-svelte": "^3.3.3",
+		"rehype": "^13.0.2",
 		"rehype-autolink-headings": "^7.1.0",
 		"rehype-github-alerts": "^3.0.0",
 		"rehype-slug": "^6.0.0",
 		"shaku-code-annotate-shiki": "^0.10.0",
 		"shaku-code-annotate-shiki-transformer": "^0.2.4",
 		"svelte": "^5.22.4",
-		"typescript": "^5.8.2"
+		"typescript": "^5.8.2",
+		"unist-util-visit": "^5.0.0"
 	},
 	"devDependencies": {
 		"@astropub/md": "^1.0.0",