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:
- GitHub: richiepagard (Richie)
- Email: richiepagard@gmail.com
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f41eba49f80230751ec658152e02e027f5b1c605d187993275e5b288d449416b
|
|
| MD5 |
c96560428d5bddfba39c6d55f7da94e6
|
|
| BLAKE2b-256 |
06fc28dc050e2093b8bc122978c6c4a4f7b606f7df7c4eccaca798be10cc6580
|
File details
Details for the file markdown_to_png-1.1.5-py3-none-any.whl.
File metadata
- Download URL: markdown_to_png-1.1.5-py3-none-any.whl
- Upload date:
- Size: 4.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ff4ab760098f0f1c4404488dcb4da25deade986f48ec336200e55d86b66dc49
|
|
| MD5 |
cf3e96256acd190cdca61eabb6652a62
|
|
| BLAKE2b-256 |
ed70fd2e7d4e34aa05bec74b4b0c548e4e4eaa5639069eb8b74a339e14e507f5
|