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.1771476332

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.1771476332
File	Size	Uploaded
yaml_to_markdown-0.1.1771476332.tar.gz	581.1 kB	Feb 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for yaml-to-markdown 0.1.1771476332
File	Interpreter	ABI	Platform	Reset
yaml_to_markdown-0.1.1771476332-py3-none-any.whl 10.0 kB Feb 19, 2026	Python 3	none	any	Details

Total release size: 591.2 kB

Release files / yaml_to_markdown-0.1.1771476332.tar.gz

Download URL	yaml_to_markdown-0.1.1771476332.tar.gz
Size	581.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`4738e16aa56fd86c8bffabe6cac43218212f8a5cffaa7679f45326c09e162553`
BLAKE2b-256 checksum How to use checksums	`df86e27d97baa5d1bbd2d8656e841d40a05360183700e25122851343576bb5fc`
Upload date	Feb 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

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

Download URL	yaml_to_markdown-0.1.1771476332-py3-none-any.whl
Size	10.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`59eddba7cd053cfaa296b3b9cea1bba4eddcefd7658da37c7be838c5eeffa0c0`
BLAKE2b-256 checksum How to use checksums	`bb0bef7d6ab31b26c1c6c6867823b971864af032e2e802846b92eea3fc6798f7`
Upload date	Feb 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`