Markdown for Teams in Markdown

Lessons in this section

1. Markdown Flavors

   Render one README as CommonMark, as GitHub Flavored Markdown and on a docs site. Learn the four layers of Markdown, what GFM adds, which features are platform extensions, what each one falls back to, and how to write a file that works everywhere.

2. Docs as Code

   Treat docs like code. Lint a docs page with fourteen problems, lay out a docs folder, write a README that answers the first five questions, write one sentence per line for clean diffs, and add Mermaid diagrams and alerts.

3. Frontmatter Basics

   Write the YAML block at the top of a Markdown file. Fix a title that breaks the parser, learn keys, values, quotes, lists, groups and long text, catch the traps that silently change data, and see why AI skills depend on frontmatter.