Skip to main content

A Python package designed to convert Markdown files into beautifully styled PNG images.

Project description

Markdown To PNG

markdown-to-png is a Python package designed to convert Markdown files into beautifully styled PNG images. Whether you want to create visually appealing graphics from text or simply share Markdown content in an image format, this tool has you covered.

This package is designed to be simple to use yet flexible enough to accommodate future enhancements and features.


Features

  • Convert Markdown files to PNG images effortlessly.
  • Support for custom CSS styling to match your desired visual design.
  • Lightweight and easy to integrate into your projects.

Installation

You can install the package using pip (once published to PyPI):

pip install markdown-to-png

If you're cloning the repository for development:

git clone https://github.com/richiepagard/markdown-to-png.git
cd markdown-to-png
pip install -e .

Usage

Here’s a basic example of how to use the package:

from markdown_to_png import convertor

# convert a markdown file to png
convertor.markdown_to_png("path/to/markdown_file.md", "path/to/output.png")

Optional Parameters

  • CSS File: Customize the style by specifying a custom CSS file.
convertor.markdown_to_png("path/to/markdown_file.md", "path/to/output.png", css_path="path/to/custom_style.css")

Future Plans

This project is a work in progress, and more features are planned for future versions:

  • Add support for multiple output formats (e.g., PDF, JPEG).
  • Command-line interface for easier use.
  • Enhanced error handling and logging.
  • Predefined themes for styling.
  • Integration with Markdown extensions like tables and footnotes.

Stay tuned for updates!


Contributing

Contributions are welcome! If you have ideas, suggestions, or bug reports, please feel free to open an issue or submit a pull request on GitHub.


License

This project is licensed under the MIT License. You are free to use, modify, and distribute this package as per the terms of the license.


Contact

If you have any questions or feedback, feel free to reach out:

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

markdown_to_png-1.1.5.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

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

markdown_to_png-1.1.5-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file markdown_to_png-1.1.5.tar.gz.

File metadata

  • Download URL: markdown_to_png-1.1.5.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.2

File hashes

Hashes for markdown_to_png-1.1.5.tar.gz
Algorithm Hash digest
SHA256 f41eba49f80230751ec658152e02e027f5b1c605d187993275e5b288d449416b
MD5 c96560428d5bddfba39c6d55f7da94e6
BLAKE2b-256 06fc28dc050e2093b8bc122978c6c4a4f7b606f7df7c4eccaca798be10cc6580

See more details on using hashes here.

File details

Details for the file markdown_to_png-1.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for markdown_to_png-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 9ff4ab760098f0f1c4404488dcb4da25deade986f48ec336200e55d86b66dc49
MD5 cf3e96256acd190cdca61eabb6652a62
BLAKE2b-256 ed70fd2e7d4e34aa05bec74b4b0c548e4e4eaa5639069eb8b74a339e14e507f5

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