Skip to content
markdown-writer logo

markdown-writer

This skill should be used when the user asks to write, edit, review, or improve Markdown content (README, docs, changelog, guides), or needs Markdown formatting, syntax help, or advanced patterns (tables, callouts, task lists, mermaid, details/summary, footnotes).

NeverSight/skills_feed0installs213stars

SKILL.md

Full skill instructions

Markdown Writer

Write clean, portable Markdown and apply advanced Markdown patterns when appropriate.

Workflow

  1. Identify the target renderer (GitHub/​GitLab/​MDX/​etc.). If unknown, assume GitHub Flavored Markdown and note compatibility when using advanced features.
  2. Keep structure scannable with headings, short paragraphs, and lists.
  3. Prefer native Markdown; use HTML only when required and supported by the target renderer.
  4. Load references/​REFERENCE.md for advanced patterns and snippets.
  5. Validate that syntax is consistent and examples are copy-pasteable.