feat: progress on the article and added GH style admonitions support

Author: lmammino

astro.config.ts

@@ -6,6 +6,8 @@ import tailwindcss from '@tailwindcss/vite'
 import { defineConfig, fontProviders } from 'astro/config'
 import expressiveCode from 'astro-expressive-code'
 import partytown from '@astrojs/partytown'
+import remarkDirective from 'remark-directive' /* Handle ::: directives as nodes */
+import { remarkAdmonitions } from './src/plugins/remark-admonitions' /* Add admonitions */
 
 // https://astro.build/config
 export default defineConfig({
@@ -16,6 +18,9 @@ export default defineConfig({
     sitemap(),
     partytown({ config: { forward: ['dataLayer.push'] } }),
   ],
+  markdown: {
+    remarkPlugins: [remarkDirective, remarkAdmonitions],
+  },
   vite: {
     plugins: [tailwindcss()],
   },

package.json

@@ -30,24 +30,33 @@
     "clsx": "^2.1.1",
     "daisyui": "^5.0.43",
     "framer-motion": "^12.15.0",
+    "hastscript": "^9.0.1",
     "lucide-react": "^0.511.0",
+    "mdast": "^3.0.0",
+    "mdast-util-directive": "^3.1.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "mdast-util-to-string": "^4.0.0",
     "ogl": "^1.0.11",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "rehype-accessible-emojis": "^0.3.2",
+    "remark-directive": "^4.0.0",
     "remark-toc": "^9.0.0",
     "sharp": "^0.34.3",
     "swiper": "^11.2.10",
     "tailwind-merge": "^3.3.0",
     "tailwindcss": "^4.1.8",
-    "three": "^0.180.0"
+    "three": "^0.180.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0"
   },
   "packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
   "devDependencies": {
-    "@eslint/js": "9.35.0",
-    "@types/three": "^0.180.0",
+    "@eslint/js": "latest",
+    "@types/mdast": "^4.0.4",
+    "@types/three": "latest",
     "@typescript-eslint/eslint-plugin": "8.37.0",
-    "@typescript-eslint/parser": "8.43.0",
+    "@typescript-eslint/parser": "latest",
     "astro-eslint-parser": "1.2.2",
     "eslint": "9.35.0",
     "eslint-config-prettier": "10.1.8",