markdown-mermaid-to-images 0.1.0

Exports mermaid diagrams in Markdown documents as images.

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] Path to folder where to save the new markdown files.

--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 [e-mail]: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.