markdown-expert

Write and format Markdown documents with correct syntax across GFM, CommonMark, and Pandoc.

Updated Jan 31, 2026

Search Tags:#linting #markdown #formatting #frontmatter #GFM #CommonMark #Pandoc

Ready to run

npx skills add https://github.com/MGriot/.gemini --skill markdown-expert-mgriot

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: markdown-expert
Source: https://github.com/MGriot/.gemini/tree/main/skills/markdown-expert
Command: npx skills add https://github.com/MGriot/.gemini --skill markdown-expert-mgriot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Markdown writing and formatting often lacks consistency across flavors and tools; this skill guides experts to write clean, well-formatted Markdown (GFM, CommonMark, Pandoc) and leverage advanced features.

Core Features & Use Cases

Flavor guidance across GFM, CommonMark, and Pandoc.
Advanced features: tables, diagrams, frontmatter, footnotes, and HTML embedding.
Use Case: When producing technical docs or README files, ensure consistent style and correct syntax across platforms.

Quick Start

Review a Markdown document for correct syntax and flavor compatibility and apply recommended formatting updates.

Frequently Asked Questions about markdown-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I format Markdown documents with correct syntax across different flavors?▼

To format Markdown documents correctly, you must apply syntax rules specific to GitHub Flavored Markdown (GFM), CommonMark, and Pandoc, ensuring consistent style for tables, diagrams, and footnotes across platforms.

What is the best way to lint and validate Markdown formatting for technical documentation?▼

The best way to lint Markdown formatting is using tools like markdownlint and Prettier to enforce best practices, validate syntax, and achieve consistent formatting across README files and technical documents.

How do I add frontmatter and footnotes in GitHub Flavored Markdown?▼

To add frontmatter and footnotes in GitHub Flavored Markdown, you use specific syntax blocks at the beginning and end of your document, leveraging advanced features while maintaining compatibility with CommonMark standards.

Does Pandoc Markdown support advanced features like tables and diagrams?▼

Yes, Pandoc Markdown supports advanced features including complex tables, diagrams, footnotes, and HTML embedding, allowing you to produce comprehensive technical documents and README files with correct syntax.

Why does my Markdown formatting break when moving between CommonMark and GFM?▼

Markdown formatting breaks between CommonMark and GFM because they are different flavors with varying syntax rules for advanced features like tables and HTML embedding; enforcing best practices ensures compatibility.