← Context / general
Render AST in Debug
Exploration of AST structure at each stage of markdown processing to understand how to handle callouts
Objective
Before implementing callout rendering, we need to understand exactly how the AST looks at each stage of processing. This exploration will:
-
Add debug logging to show the AST structure:
- After initial markdown parsing
- After each remark plugin
- After rehype conversion
- Before final HTML rendering
-
Focus on understanding:
- How blockquotes are represented in the AST
- Where callout syntax appears in the node structure
- What node types we need to work with
- Best points to intercept for transformation
-
Create a clean baseline without any transformation logic:
- Remove existing callout handling code
- Add comprehensive debug output
- Document the AST structure at each stage
Implementation Plan
- Remove existing callout transformation code
- Add debug logging to
[vocabulary].astro - Add debug logging to each remark plugin
- Create test markdown files with various callout patterns
- Document the AST structure we observe
Success Criteria
- Clear visibility of AST at each processing stage
- Understanding of where callout syntax appears
- Documentation of node types and structure
- Clean baseline for implementing new transformation approach