Converts a YAML/JSON file or python Dict/List to a Markdown file
Project description
YAML to Markdown Converter
A Python utility to take a JSON / YAML file or a python dict / list and create a Markdown file.
Installation
pip install yaml-to-markdown
Usage
$ yaml-to-markdown --help
Convert JSON or YAML to Markdown.
Usage: yaml-to-markdown -o <output_file> [-y <yaml_file> | -j <json_file>]
-o, --output-file <output_file>: Path to the output file as a string [Mandatory].
-y, --yaml-file <yaml_file>: Path to the YAML file as a string [Optional]
-j, --json-file <json_file>: Path to the JSON file as a string [Optional]
-h, --help: Show this message and exit.
Note: Either yaml_file or json_file is required along with output_file.
Example: yaml-to-markdown -o output.md -y data.yaml
In Python Code example:
Convert a Pyton dictionary to Markdown:
from yaml_to_markdown.md_converter import MDConverter
data = {
"name": "John Doe",
"age": 30,
"city": "Sydney",
"hobbies": ["reading", "swimming"],
}
converter = MDConverter()
with open("output.md", "w") as f:
converter.convert(data, f)
Content of output.md
file will be:
## Name
John Doe
## Age
30
## City
Sydney
## Hobbies
* reading
* swimming
From the Command Line
You can also use the command line interface to convert a JSON or YAML file to Markdown. Here's an example:
Convert a JSON file to Markdown:
yaml-to-markdown --output-file output.md --json-file test.json
Convert a YAML file to Markdown:
yaml-to-markdown --output-file output.md --yaml-file test.yaml
Developer Guide
Please see the DEVELOPER.md file for more information on how to contribute to this project.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for yaml_to_markdown-0.1.1722388589.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a9a30ac912c06d5dc237b9b906de6768b56646a51e2aa75d8c0c14dba34bcd61 |
|
MD5 | b49a3355a2447b2fc9d2a411c686f518 |
|
BLAKE2b-256 | 25745ba982dd3b9598de293284a233de3bf2e7962d6cfa605b7b19f4914934f5 |
Close
Hashes for yaml_to_markdown-0.1.1722388589-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb3edfc187a10d9490df8851c0c87212db8abfecbe9c38e9ae6d9951e29d6047 |
|
MD5 | 03f23d8164e76a368b774d33bf5a8e56 |
|
BLAKE2b-256 | 1cc4fb3b6809ac1237f9e79133547a0f3f3cc8e1b862df63560103fd04f205bc |