mksync

MkSync replaces directives in a Markdown file with corresponding content. It's a useful tool to add nice features to your project's README.md file, such as a table of contents, without the manual upkeep.

• Example
• Available Directives
• Synopsis
• Changelog
  • 0.1.6 (2025-07-31)
  • 0.1.5 (2025-07-31)
  • 0.1.4 (2023-06-29)
  • 0.1.3 (2023-06-29)

Example

Say this is your README.md:

# My Project

<!-- toc -->

## Installation

## Documentation

Then running mksync README.md will update the file in-place to:

# My Project

<!-- toc -->
* [Installation](#installation)
* [Documentation](#documentation)
<!-- end toc -->

## Installation

## Documentation

Available Directives

• toc or table of contents: Produce an unordered list of links to all headers in the document after the directive.
• include <path>: Include the contents of the file at the given path. You can optionally specify a language name to wrap the content in a code block, e.g. include code:python <path>.
• runcmd <command>: Run the given command and include the output in the document. You can optionally specify a language name to wrap the output in a code block, e.g. runcmd code:python <command>.

Synopsis

usage: mksync [-h] [--inplace] [--verbose] [--change-dir] file

MkSync is a utility to update Markdown files in-place to automate some common upkeep tasks, such as inling
example code and updating table of contents.

positional arguments:
  file              the file to process

options:
  -h, --help        show this help message and exit
  --inplace, -i     update the file in-place
  --verbose, -v     enable verbose logging
  --change-dir, -c  change into parent directory of the file

Changelog

0.1.6 (2025-07-31)

0.1.5 (2025-07-31)

0.1.4 (2023-06-29)

0.1.3 (2023-06-29)