No project description provided
Project description
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
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
ortable 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] 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
Changelog
0.1.3 (2023-06-29)
Type | Description | PR | Issues | Author |
---|---|---|---|---|
Fix |
Fix parsing of | @NiklasRosenstein |
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mksync-0.1.3.tar.gz
(7.7 kB
view hashes)
Built Distribution
mksync-0.1.3-py3-none-any.whl
(10.4 kB
view hashes)