Skip to main content

processes a Markdown file by including the contents of other Markdown files

Project description

markdown_include

This is a simple Python script that processes Markdown files by including the contents of other Markdown files.

The script takes in a Markdown file as input, looks for lines that are similar to <!-- include (filename) --> (Parentheses are necessary to identify the path) and treats them as include directives. For each include directive, the script reads the specified file and writes its contents to the output file. The result is a new Markdown file that includes the contents of all included files.

Github

https://github.com/hxtmike/markdown_include

Usage

To use the script, simply pass the input file name and the output file name as command-line arguments. The script will process the input file, generate the output file, and exit. Here's an example of how to run the script:

md_incl input_file.md output_file.md

This script will be added as a command after installation

Features

  • Processes Markdown files by including the contents of other Markdown files
  • Supports include directives in the format of <!-- include (filename) --> (Parentheses are necessary to identify the path)
  • Outputs a new Markdown file that includes the contents of the included files
  • Takes in input and output file names as command-line arguments

Requirements

  • >Python 3.8
  • A text editor to modify the input and included files

Installation

pip install md-incl

It could be used in some building system like Makefile, which allows for the automatic assembly of large and complex reports and papers.

Contributions

If you'd like to contribute to the development of this script, feel free to fork the repository and submit a pull request. I'll be happy to review your changes and merge them into the main codebase.

License

This script is licensed under the MIT License. See the LICENSE file for details.

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

md_incl-0.0.1.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

md_incl-0.0.1-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file md_incl-0.0.1.tar.gz.

File metadata

  • Download URL: md_incl-0.0.1.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for md_incl-0.0.1.tar.gz
Algorithm Hash digest
SHA256 7e3100341cff174f28473b25b8e2bbad0f3982c59d2e1e1d061fa282a8b57cb8
MD5 3de0acf66ab3d46dfd22e34d6d0a119f
BLAKE2b-256 593db981d853e73c7840ee0908b950aa847b9131e14b617e2a45361dc7583cea

See more details on using hashes here.

File details

Details for the file md_incl-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: md_incl-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 4.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for md_incl-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b2f09354f587baa6f874864f4a8ce3d9f487ee46b8af1744094b3b6f786484ce
MD5 6d32e99da00d05e8ebc0d2308df250c3
BLAKE2b-256 1a40f0e11a24b7a32c053078b7740cb9aaa3e888704a873e234a385d2a093f5e

See more details on using hashes here.

Supported by

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