Skip to main content

Convert Markdown files to styled HTML with a GitHub-like appearance. Easily switch between light and dark modes.

Project description

MDHub

banner

GitHub PyPI

Easily convert Markdown files to styled HTML. Perfect for delivering projects to clients who might not be familiar with .md files.

Table of Contents

Why MDHUB?

Sometimes when delivering projects to clients, they might not be familiar with Markdown or might not have the necessary tools to render it. Online converters often don't replicate the GitHub styling, and might not support dark/light modes. MDHUB fills this gap by providing a simple tool to convert Markdown files to styled HTML that resembles GitHub's own rendering, with support for both dark and light themes.

The name

The name "mdhub" is a nod to the central theme of our tool – making your Markdown files look and feel like they're on GitHub. "md" stands for Markdown, and "hub" alludes to a central place or repository, reminiscent of GitHub where a lot of Markdown content is commonly hosted and viewed. Our goal is to bring that familiar and stylish GitHub appearance to your Markdown files, no matter where they're viewed from, hence the name "mdhub".

Features

  • Converts .md files to .html with GitHub-like styling.
  • Supports both dark and light modes.
  • Simple CLI interface for easy use.

Installation

You can easily install MDHUB using pip:

pip3 install mdhub

Usage

Run the tool using the following command:

mdhub <inputfile.md (default is README.md)> <optional output file name (default is README.html)> <light or dark mode (default is dark)>

For example, to convert sample.md to output.html in dark mode:

mdhub sample.md output.html

Or to convert README.md to README.html in dark mode (using default values):

mdhub

My links

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

mdhub-0.1.1.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.

mdhub-0.1.1-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file mdhub-0.1.1.tar.gz.

File metadata

  • Download URL: mdhub-0.1.1.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for mdhub-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a746d801ec113c240a17a00f41e6e29b829c6bf00f9df0a1ae1377d6a7fb989c
MD5 bd5baae36508f086df7b69ad6dcc0d6e
BLAKE2b-256 e48b2aac9ac3c5c873ec01d6094028adf98362e353b8629c88171fe995938ad5

See more details on using hashes here.

File details

Details for the file mdhub-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: mdhub-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for mdhub-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d361d15f311435717fd4c20d5c54b3c537447992649669210cdcd35944730716
MD5 7e475a70fc3186082947eb9218ecb877
BLAKE2b-256 ff5cf600512532232b83d8029dcfc577a3806c0381140d5dc79c52020e1b320b

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