Skip to main content

Compiles multiple markdown files into a single README.md

Project description

compileMD

Brief introduction

Markdown files are a popular format for technical project documentation, but as the amount of docu grows, the files can become long and difficult to manage. The solution to this problem is to break down the markdown file into smaller, more manageable seperate .md files and then compile them into a single file i.e., README.md. Hence, compileMD tries to solve this problem.

compileMD compile markdown files into the single README.md.

Installation

$ pip3 install --user compileMD

How to use compileMD?

For simplicity, create the following folders and files:

$ mkdir testing
[ testing]$ mkdir md_docs
[ md_docs]$ vi 00_intro.md

# Project Title
A brief description of what this project does and who it's for.
[ md_docs]$ vi 01_installation.md

## Installation
Install my-project with npm ...

Now, run compileMD:

[ testing]$ compileMD
[info] Compiling 00_intro.md into ./README.md
[info] Compiling 01_installation.md into ./README.md

testing tree looks like this:

.
├── md_docs
│   ├── 00_intro.md
│   ├── 01_installation.md
└── README.md

Related

Here are some related links for this repo:

Contributing

Contributions are always welcome! Please contact hello@amaharjan.de.

License

MIT

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

compileMD-0.2.1.tar.gz (2.5 kB view details)

Uploaded Source

Built Distribution

compileMD-0.2.1-py3-none-any.whl (2.9 kB view details)

Uploaded Python 3

File details

Details for the file compileMD-0.2.1.tar.gz.

File metadata

  • Download URL: compileMD-0.2.1.tar.gz
  • Upload date:
  • Size: 2.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.11

File hashes

Hashes for compileMD-0.2.1.tar.gz
Algorithm Hash digest
SHA256 39f85e56c71110b9f7fc15c61533d02d21e3dba6913a345980f49f3e08654296
MD5 c62c3cb662a9f6497f75425330a1ba4d
BLAKE2b-256 25036d9b7246ef1e17af59623f7c18d47560374ae55ac9441803d5de3aa0f2cc

See more details on using hashes here.

File details

Details for the file compileMD-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: compileMD-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 2.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.11

File hashes

Hashes for compileMD-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 82568cafc0b8c014c2ec1f468ce05fa6f0bf018cfc88f7461629f7988406aaeb
MD5 94ffae0c5240e4e67189097f3d0e88a5
BLAKE2b-256 304c07d4ed92d8c0b28ea8af16188cb60e8b372040f6ebd2d6e8ebf2afe2bf3b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page