Google Markdown Style Guide

Official Google Markdown formatting standards for consistent documentation.

Quick Reference

Golden Rules

1. One sentence per line — easier diffs and reviews
2. ATX-style headers — use # not underlines
3. Fenced code blocks — use ``` with language
4. Reference-style links — for repeated URLs
5. Consistent list markers — - for unordered, 1. for ordered
6. Blank lines around blocks — improve readability
7. 80-character line limit — for prose

Headers (Preview)

# Top Level Header

## Second Level

### Third Level

Code Blocks (Preview)

````markdown

def hello():
    print("Hello, world!")

````

Lists (Preview)

- First item
- Second item
  - Nested item
  - Another nested

1. Ordered first
2. Ordered second

Links (Preview)

[Google](https://google.com)

[Google][google-link]

[google-link]: https://google.com

When to Use This Guide

• Writing documentation
• README files
• Technical writing
• Code reviews
• Onboarding new team members

Install

npx skills add testdino-hq/google-styleguides-skills/markdown

Full Guide

See [markdown.md](markdown.md) for complete details, examples, and edge cases.