forked from oruelle/md_mermaid
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
62a1f15
commit 60d18ef
Showing
3 changed files
with
76 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,74 @@ | ||
# md_mermaid | ||
mermaid extension to add support for mermaid graph inside markdown file | ||
mermaid extension for Python-Markdown to add support for mermaid graph inside markdown file | ||
|
||
## Installation | ||
|
||
* pip (only python version >=3.x) : | ||
|
||
~~~shell | ||
pip install markdown | ||
pip install md-mermaid | ||
~~~ | ||
|
||
## Usage | ||
|
||
In your python script : | ||
|
||
~~~python | ||
import markdown | ||
|
||
text = """ | ||
# Title | ||
Some text. | ||
~~~mermaid | ||
graph TB | ||
A --> B | ||
B --> C | ||
~~~ | ||
Some other text. | ||
~~~mermaid | ||
graph TB | ||
D --> E | ||
E --> F | ||
~~~ | ||
""" | ||
|
||
html = markdown.markdown(text, extensions=['md_mermaid']) | ||
|
||
print(html) | ||
~~~ | ||
|
||
Output will result in : | ||
|
||
~~~html | ||
<h1>Title</h1> | ||
<p>Some text.</p> | ||
<div class="mermaid"> | ||
graph TB | ||
A --> B | ||
B --> C | ||
</div> | ||
|
||
<p>Some other text.</p> | ||
<div class="mermaid"> | ||
graph TB | ||
D --> E | ||
E --> F | ||
</div> | ||
|
||
<script>mermaid.initialize({startOnLoad:true});</script> | ||
|
||
~~~ | ||
|
||
The `<script>...</script>` line appears only once even if there are several graphs in the file. | ||
|
||
> Note that the extension name have a '_' not a '-'. | ||
> Attention : don't forget to include in your output html project the two following mermaid files : | ||
> | ||
> * mermaid.css (optional, can be customised) | ||
> * mermaid.min.js (can be download here [here](https://unpkg.com/[email protected]/dist/)) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,7 +6,7 @@ | |
|
||
setup( | ||
name='md_mermaid', | ||
version='0.1.1', | ||
version='0.1.0', | ||
author='Olivier Ruelle', | ||
author_email='[email protected]', | ||
description='Python-Markdown extension to add support for mermaid graph inside markdown file.', | ||
|