consolidate-markdown · v1.1.0 · 2026-10-01 · sha256 c903820cca27b277
consolidate-markdown v1.1.0A
Immutable. This exact content never changes and is served at /api/v1/blob/c903820cca27b277.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_ckdtrhydtcjxssvz/c903820cca27b2774908666548393ab51fbcf6df4f8b68439bca3f6ad4d5d9fa.json
Then /plugin install consolidate-markdown@markdownregistry-ckdtrhydtcjxssvz in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: consolidate-markdown description: "Consolidate several unstructured Markdown files with overlapping or conflicting information into one organized document, without losing data and with every divergence made explicit. Use when user says 'consolidar arquivos markdown', 'juntar essas notas', 'merge these md files', 'unify these docs', 'notas duplicadas/divergentes', or has multiple .md notes (Obsidian, Notion exports, scattered docs) covering the same topics with inconsistent details, even if they don't say 'consolidate'." metadata: author: Ronnasayd Machado - github.com/Ronnasayd version: "1.1.0" --- # Consolidate Markdown Merge messy `.md` files into one coherent document. Rule: **no info lost, no conflict silently resolved**. Keep source traceability until the final step — it's what makes divergences resolvable. Never edit originals. Ask (`AskUserQuestion`) only what can't be inferred: files/glob, output path (default `consolidado.md` beside sources), output language, keep/drop frontmatter. ## Steps | # | Step | Action | Gate | | --- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | 1 | Prepare | UTF-8 + LF (`file -i`, `iconv -f <enc> -t utf-8`, `sed -i 's/\r$//'`). Frontmatter keep/drop per user; if kept, move date/tags into origin header | work on copy; accents intact | | 2 | Concatenate | Oldest first (frontmatter date or mtime) so contradictions read as updates; origin header per file (snippet below); exclude output file from glob | draft with `# Origem: <file>` per block | | 3 | Unify | Read full draft → propose 5–12 macro-themes (confirm if split non-obvious) → move blocks under themes, keep wording, tag `<!-- src: file.md -->` → mark conflicts (template below) | every block under a theme; every conflict marked | | 4 | Refine | Resolve per table below; dedupe; one H1; consistent lists/tables; working links. Strip `src` comments and `# Origem` only after user approves | unresolved → final `## Pendências` | | 5 | Verify | Each source's distinct facts appear in output or `Pendências`; grep (`rg -c`) unusual terms/numbers/names per source | report: files merged, themes, dupes collapsed, divergences found/resolved/pending | ```bash out=consolidado_rascunho.md; : > "$out" for f in *.md; do printf '\n\n# Origem: %s\n\n' "$f" >> "$out"; cat "$f" >> "$out"; done ``` ```markdown > ⚠️ **Divergência:** prazo do projeto > > - `notas_v1.md`: 30 dias > - `reuniao_03.md`: 45 dias > > **Decisão:** _pendente_ ``` ## Conflict handling | Case | Action | | ---------------------------- | ----------------------------------------------------------------------------------- | | Same fact, same value | collapse to one line, list all sources | | Same fact, different wording | not a conflict — merge | | Different values | mark divergence; resolve by newer date, more authoritative source, or user decision | | Resolved | record chosen value + why; keep rejected value as one-line note if it could matter | | Unresolvable | leave in `## Pendências` | | >10 divergences | also list in reply grouped by theme for one-pass decision | ## Output Final `.md`: TOC, themed sections, `Pendências`; short summary to user.