Markdown Content Conventions

Quick Reference

• Heading levels: H2-H3 for structure (H1 auto-generated from title)
• Line length: 400 characters max for readability
• Language: New Zealand English spelling and grammar
• Code blocks: Use fenced blocks with language specification
• Front matter: YAML metadata at file start

Content Rules

1. Headings

• Use ## for H2 and ### for H3
• Ensure hierarchical structure (don't skip levels)
• Do not use H1 (#) - auto-generated from title
• Recommend restructuring if content requires H4
• Strongly recommend restructuring for H5+