Git-native, conflict-free
July 1, 2026 ยท View on GitHub
Generated blocks are a merge magnet. Two branches both regenerate a table of contents, and Git reports a conflict in content no human wrote.
mdsmith merge-driver install registers a Git merge driver for
those blocks. On a conflict it re-runs the directive and keeps
the regenerated body, so the conflict never reaches you.
mdsmith pre-merge-commit install adds a hook that runs
mdsmith fix after a merge and re-stages the .md files. The
hook itself is kept in sync by MDS048, which checks the Git
artifacts against the template derived from .mdsmith.yml.
See the merge-driver and pre-merge-commit references for installation.