Skip to main content

Exports mermaid diagrams in Markdown documents as images.

Project description

Pipeline Status Coverage PyPI Project License PyPI Project Version

markdown-mermaid-to-images

A CLI tool for publishing markdown articles to dev.to. The tool will also update articles if they already exist on dev.to. It matches articles based on title in the frontmatter.

Usage

pip install markdown-mermaid-to-images
markdown_mermaid_to_images --help

Usage: markdown_mermaid_to_images [OPTIONS]

Exports mermaid diagrams in Markdown documents as images.
Options:
-m, --file PATH
 Path to markdown file, where the mermaid code blocks will be converted to images.
-f, --folder PATH
 Path to folder where we will convert all markdown mermaid code blocks to images.
-i, --ignore PATH
 Path to folder to ignore, markdown files in this folder will not be converted.
-o, --output PATH
 Path to folder where to save the new markdown files. [required]
-l, --log-level
 [DEBUG|INFO|ERROR] Log level for the script.
--help Show this message and exit.
$ markdown_mermaid_to_images -f tests/data -o tests/data/output/ -i tests/data/another_folder

Example Markdown File

Where an example markdown file may look something like this. The meramid code blocks must be surrounded by three ` and have the class mermaid.

## Introduction

Example Document

## Heading

```mermaid
graph LR;
  A --> B;
```

> INFO: Info

```mermaid
graph LR;
  A --> B
  B --> C
  subgraph 1;
  subgraph 2;
  C --> D;
  end
  end;
```

This will then get converted into a file that looks like

Introduction
------------

Example Document

Heading
-------

![Image](a18fcc0f6bf14950b5115b22752471cc.png)

> INFO: Info

![Image](7d2490309c1c4bf48069dd7399944ff4.png)

GitLab CI

You can use also use this in your CI/CD with the provided Docker image. Below is an example .gitlab-ci.yml file, you may wish to use or include. The advantage of this is you can publish your aritcles using CI/CD.

stages:
  - pre-publish

convert-mermaid:markdown:
  image: registry.gitlab.com/hmajid2301/markdown-mermaid-to-images
  stage: pre-publish
  script:
    - markdown_mermaid_to_images --folder tests/data --ignore tests/data/another_folder --output tests/data/output

Setup Development Environment

git clone git@gitlab.com:hmajid2301/markdown-mermaid-to-images.git
cd markdown-mermaid-to-images
pip install tox
make install-venv
source .venv/bin/activate
make install-dev

Changelog

You can find the changelog here.

Appendix

Docker Image inspired by sc250024

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for markdown-mermaid-to-images, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size markdown-mermaid-to-images-0.1.5.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page