# Astro with Markdoc

import DocButton from '~/components/webkit/DocButton.vue';
import SectionBasicContent from '~/components/SectionBasicContent/SectionBasicContent.vue';
import Container from '~/components/webkit/Container.vue';

<SectionBasicContent
  description="The Astro with Markdoc template deploys a new application based on Astro working with the experimental Markdoc integration. This template combines Astro's static site generation with Markdoc's powerful documentation capabilities, allowing you to create rich, interactive documentation with custom components and validation."
  buttons={[
    { label: "Deploy template", link: "https://console.azion.com/create/astro/astro-with-markdoc", outlined: false, icon: "ai ai-azion", iconPos: "left" },
    { label: "View demo", link: "https://i4pasdspx5.map.azionedge.net/", severity: "secondary" }
  ]}
>
  <Fragment slot="content">
    <div style="flex: 1; min-width: 300px;">
      | Item | Details |
      |:----------|:------|
      | Repository | [Azion Samples](https://github.com/aziontech/azion-samples/tree/dev/templates/astro/astro-with-markdoc) |
      | Framework | [Astro](/en/documentation/products/devtools/azion-edge-runtime/frameworks-compatibility/astro/) |
      | Use Case | General |
    </div>
    <div style="display: flex; justify-content: center; align-items: center; flex: 1;">
      <img src="/assets/docs/images/uploads/template-showcase/astro/astro-markdoc.png" width="400" alt="Astro with Markdoc" style="min-width: 100%; max-width: 100%; height: auto;" />
    </div>
  </Fragment>
</SectionBasicContent>

## About this template

This template wires [Astro](/en/documentation/products/devtools/azion-edge-runtime/frameworks-compatibility/astro/) together with the Markdoc integration, a Markdown-based authoring system created by Stripe. Markdoc lets you embed custom components and validate content with a defined schema, making it well suited to documentation and structured articles. Delivered through Azion, the resulting static pages are served via a distributed architecture for fast access worldwide.

## Key features

- Astro content authored with Markdoc's extended Markdown syntax.
- Custom tags and nodes for embedding interactive components in content.
- Schema-based validation that keeps documents consistent and reliable.
- One-click deployment to Azion's globally distributed global network.