Skip to content

Conversation

mavam
Copy link
Member

@mavam mavam commented May 29, 2025

Important

Blocked by withastro/astro#13868

Summary

Migrates documentation partials from MDX to Markdoc format for better performance and consistency.

Key Changes

  • Partials: Converted 12 MDX partials to Markdoc with improved naming (_snake_case.mdoc)
  • Call sites: Converted 63 files that use partials from .mdx to .mdoc
  • Syntax: Updated to use Markdoc partial syntax with proper variable interpolation
  • Aside tags: Converted ::: syntax to {% aside %} tags in .mdoc files
  • Path fixes: Corrected relative paths for proper partial resolution

Impact

  • ✅ Targeted conversion (only files using partials)
  • ✅ Preserved original partial placement in content
  • ✅ All builds passing
  • ✅ No breaking changes to existing MDX files

@mavam mavam force-pushed the topic/markdoc-partials branch from 93625aa to 9a705ef Compare May 29, 2025 09:04
Copy link
Contributor

🚀 Preview deployed!

Visit the preview at: https://tenzir-docs-preview-25.surge.sh

This preview will be updated automatically on new commits.

@mavam mavam marked this pull request as ready for review May 29, 2025 10:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant