Extensions & Appendices
7. Extensions
Section titled “7. Extensions”7.1 Custom Frontmatter Fields
Section titled “7.1 Custom Frontmatter Fields”Implementations MAY add custom frontmatter fields prefixed with x-:
x-review-board: ["alice", "bob"]x-implementation-phase: 2Custom fields MUST NOT conflict with reserved field names.
7.2 Custom Sections
Section titled “7.2 Custom Sections”Implementations MAY add custom sections after the Audit section.
8. MIME Type
Section titled “8. MIME Type”The RECOMMENDED MIME type for Structured MADR documents is:
text/markdown; variant=structured-madr9. Security Considerations
Section titled “9. Security Considerations”- Frontmatter SHOULD NOT contain sensitive information
- File paths in audit findings SHOULD be relative
- External links SHOULD use HTTPS
Appendix A: Complete Example
Section titled “Appendix A: Complete Example”See examples/complete-example.md for a fully compliant example.
Appendix B: Changelog
Section titled “Appendix B: Changelog”Version 1.0.0 (2026-01-15)
Section titled “Version 1.0.0 (2026-01-15)”- Initial release
- YAML frontmatter specification
- Body section requirements
- Audit section specification
- JSON Schema definition