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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page