🔧 Add markdoc

Add markdoc for authoring content.
ADR: https://www.notion.so/Use-Markdoc-to-author-Centrapay-Docs-content-1a9be0b4f3a641068e9b4a97db7ccf50

astro.config.mjs

@@ -1,7 +1,6 @@
 import { defineConfig } from 'astro/config';
 import flexsearchPlugin from './src/plugins/flexsearch';
 
-// https://astro.build/config
 import tailwind from '@astrojs/tailwind';
 
 // https://astro.build/config
@@ -14,21 +13,20 @@ import { mermaid } from './src/plugins/mermaid';
 // https://astro.build/config
 import mdx from '@astrojs/mdx';
 
+// https://astro.build/config
+import markdoc from '@astrojs/markdoc';
+
 // https://astro.build/config
 export default defineConfig({
   site: 'https://docs.centrapay.com',
   integrations: [
     vue(),
-    tailwind({
-      applyBaseStyles: false,
-    }),
-    mdx()
+    tailwind({ applyBaseStyles: false }),
+    mdx(),
+    markdoc()
   ],
   markdown: {
-    remarkPlugins: [
-      remarkSectionize,
-      mermaid,
-    ],
+    remarkPlugins: [remarkSectionize, mermaid],
     shikiConfig: {
       // Choose from Shiki's built-in themes (or add your own)
       // https://github.com/shikijs/shiki/blob/main/docs/themes.md

markdoc.config.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": "centrapay-docs",
+    "path": "src/content",
+    "schema": {
+      "path": "markdoc.config.mjs",
+      "type": "esm",
+      "property": "default",
+      "watch": true
+    }
+  }
+]

markdoc.config.mjs

@@ -0,0 +1,16 @@
+import { defineMarkdocConfig, component } from '@astrojs/markdoc/config';
+
+export default defineMarkdocConfig({
+  tags: {
+    properties: {
+      render: component('./src/components/Properties.astro'),
+    },
+    property: {
+      render: component('./src/components/Property.astro'),
+      attributes: {
+        name: { type: String, required: true },
+        type: { type: String, required: true },
+      },
+    }
+  }
+});

package.json

@@ -9,6 +9,7 @@
     "test": "vitest --watch=false"
   },
   "devDependencies": {
+    "@astrojs/markdoc": "^0.5.1",
     "@astrojs/mdx": "^1.0.3",
     "@astrojs/tailwind": "^5.0.0",
     "@astrojs/vue": "^3.0.0",
@@ -17,7 +18,7 @@
     "@fontsource/inter": "^4.5.15",
     "@headlessui/vue": "^1.6.0",
     "@tailwindcss/typography": "^0.5.8",
-    "astro": "^3.0.12",
+    "astro": "^3.2.2",
     "eslint": "^7.20.0",
     "eslint-plugin-cypress": "^2.11.2",
     "eslint-plugin-import": "^2.20.2",