Overview

Use this skill to create, format, and debug Markdown documents. It covers GitHub Flavored Markdown (GFM), CommonMark, and Pandoc, along with tools for linting and formatting.

Best Practices

Headings: Use ATX style (# Heading) instead of Setext (Heading\n===). Limit to 3 levels.
Lists: Use hyphens - for unordered lists.
Code Blocks: Always specify the language in fenced code blocks (e.g., ```python).
Line Length: Wrap text at 80 characters for readability (unless using a renderer that doesn't support soft breaks, but GFM does).
Formatting: Use prettier for automatic formatting.
Linting: Use markdownlint to catch structure and style issues.

Flavors & Syntax

Different platforms use different Markdown "flavors".

Overview

Use this skill to create, format, and debug Markdown documents. It covers GitHub Flavored Markdown (GFM), CommonMark, and Pandoc, along with tools for linting and formatting.

Best Practices

Headings: Use ATX style (# Heading) instead of Setext (Heading\n===). Limit to 3 levels.
Lists: Use hyphens - for unordered lists.
Code Blocks: Always specify the language in fenced code blocks (e.g., ```python).
Line Length: Wrap text at 80 characters for readability (unless using a renderer that doesn't support soft breaks, but GFM does).
Formatting: Use prettier for automatic formatting.
Linting: Use markdownlint to catch structure and style issues.

Flavors & Syntax

Different platforms use different Markdown "flavors".

Markdown Expert

Overview

Best Practices

Flavors & Syntax

Markdown Expert

Overview

Best Practices

Flavors & Syntax

Advanced Features

Mermaid Diagrams

Tables (GFM)

Frontmatter

Feishu Wiki

Coding Agent (bash-first)

Prose

Notion

Obsidian Vault Maintainer

Wiki Maintainer