style: lint markdown files

- Remove duplicate headings (already in frontmatter)
- Optimize Mermaid diagrams
- Add emoji markers (⭐️) to key sections
- Format quotes and whitespace