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.