markdown-formatterlisted
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 `