Skip to main content

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.

Metadata

Release files for yaml-to-markdown 0.1.1736139576

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yaml-to-markdown 0.1.1736139576
File Size Uploaded
yaml_to_markdown-0.1.1736139576.tar.gz 7.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for yaml-to-markdown 0.1.1736139576
File Interpreter ABI Platform
yaml_to_markdown-0.1.1736139576-py3-none-any.whl Python 3 none any Details

Total release size: 16.9 kB

Release files / yaml_to_markdown-0.1.1736139576.tar.gz

Download URL yaml_to_markdown-0.1.1736139576.tar.gz
Size 7.9 kB
Tags Source
SHA-256 checksum
How to use checksums
81fa017ded5165be07623e23df97e6f535b442df127fdf7845981e72885dd8aa
BLAKE2b-256 checksum
How to use checksums
edc0664a522efbbcf708c39f10164670e3f73f6413fd698ceb6787cc22bc5892
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.12.4

Release files / yaml_to_markdown-0.1.1736139576-py3-none-any.whl

Download URL yaml_to_markdown-0.1.1736139576-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d7bcecc7759d233209e4fee6af584711e467f7dab8f410e86294f5fed760d9d1
BLAKE2b-256 checksum
How to use checksums
fb81dc14863e7089c03dd66ce77fb5bcd2f2c04a776c97a2126151a41beef4e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.12.4
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page