This starter showcases the experimental Markdoc integration.

npm create astro@latest -- --template with-markdoc

🧑‍🚀 Seasoned astronaut? Delete this file. Have fun!

Inside of your Astro project, you'll see the following folders and files:

/
├── public/
├── src/
│   └── content/
        └── docs/
│           └── intro.mdoc
|       └── config.ts
│   └── components/Aside.astro
│   └── layouts/Layout.astro
│   └── pages/index.astro
|   └── env.d.ts
├── astro.config.mjs
├── markdoc.config.mjs
├── README.md
├── package.json
└── tsconfig.json

Markdoc (.mdoc) files can be used in content collections. See src/content/docs/ for an example file.

You can also render Astro components from your Markdoc files using tags. See the markdoc.config.mjs file for an example configuration.

All commands are run from the root of the project, from a terminal:

Feel free to check our documentation or jump into our Discord server.