← ClaudeAtlas

markdown-formatterlisted

Zero-dependency GFM and MDX formatter with table, pipe, and fence guards for AI-agent-authored Markdown
CodeSigils/zero-md-formatter · ★ 0 · Data & Documents · score 75
Install: claude install-skill CodeSigils/zero-md-formatter
## Scope This skill formats GitHub-Flavored Markdown (GFM) and MDX (v1). In scope: GFM tables, fenced code blocks, task lists, headings, lists, blockquotes, links, autolinks, inline code, strikethrough, and MDX files. Out of scope: Obsidian wiki links, Mermaid validation, Pandoc dialects, semantic rewriting, YAML frontmatter semantics, and JSX syntax validation inside MDX. MDX note: this skill formats Markdown container syntax and does not validate JSX syntax or MDX imports/exports. Structural guards apply GFM rules to the Markdown content only. ## Runtime behavior The CLI uses the bundled `src/format-content.mjs` formatter. It has no npm runtime dependencies and does not discover external formatter configuration. Formatter-owned behavior: - Remove trailing whitespace. - Ensure a final newline. - Normalize leading tabs outside fenced code blocks. - Align GFM table columns when the table has no empty-cell ambiguity. - Normalize tilde fences to backtick fences, escalating the backtick count when nested content requires it. Guard-owned behavior: - Fence closure and malformed fence info strings. - Table column counts. - Unescaped inline-code pipes in table rows. - Adjacent-pipe table hazards. - Pre/post structural drift detection and rollback for `--guard`. ## Usage ```bash node src/index.js [options] <path...> # or via npm global install: mdfmt [options] <path...> ``` Where `<skill-dir>` resolves to your agent's skill directory, or point it at the repo root (where `