mermaid
Version:
Markdownish syntax for generating flowcharts, sequence diagrams and gantt charts.
117 lines (110 loc) • 10.4 kB
HTML
<html>
<head>
<title>index.md</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="stylesheet" media="all" href="../doc-style.css" />
<script src="../doc-filelist.js"></script>
<script>
var relativeDir = "../", thisFile = "Users/knut/Documents/source/mermaid/docs/index.md", defaultSidebar = true;
</script>
<script src="../doc-script.js"></script>
<script src="../mermaid.js"></script>
<link rel="stylesheet" href="../mermaid.css" />
</head>
<body>
<div id="sidebar_wrapper">
<div id="sidebar_switch">
<span class="tree">Files</span>
<span class="headings">Headings</span>
</div>
<div id="tree"></div>
<div id="headings">
<div class="heading h1">
<a href="#mermaid">mermaid</a>
</div>
<div class="heading h2">
<a href="#Further reading">Further reading</a>
</div>
<div class="heading h1">
<a href="#Credits">Credits</a>
</div>
</div>
</div>
<div id="sidebar-toggle"></div>
<div id="container"><div class="docs markdown"><div class="pilwrap" id="mermaid">
<h1>
<a href="#mermaid" name="mermaid" class="pilcrow">¶</a>
mermaid</h1>
</div>
<p><img src="../img/header.png" alt="Alt text"></p>
<p>Generation of diagrams and flowcharts from text in a similar manner as markdown.</p>
<p>Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?</p>
<p>This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript. <a href="http://knsv.github.io/mermaid/live_editor">Try it using our editor</a>.</p>
<p>Code examples below: </p>
<div class="highlight"><pre><code><span class="o">%%</span> <span class="nx">An</span> <span class="nx">example</span> <span class="nx">of</span> <span class="nx">a</span> <span class="nx">flowchart</span>
<span class="nx">graph</span> <span class="nx">TD</span><span class="p">;</span>
<span class="nx">A</span><span class="o">--</span><span class="nx">B</span><span class="p">;</span>
<span class="nx">A</span><span class="o">--</span><span class="nx">C</span><span class="p">;</span>
<span class="nx">B</span><span class="o">--</span><span class="nx">D</span><span class="p">;</span>
<span class="nx">C</span><span class="o">--</span><span class="nx">D</span><span class="p">;</span>
</code></pre></div>
<div class="highlight"><pre><code><span class="o">%%</span> <span class="nx">An</span> <span class="nx">example</span> <span class="nx">of</span> <span class="nx">a</span> <span class="nx">sequence</span> <span class="nx">diagram</span>
<span class="nx">sequenceDiagram</span>
<span class="nx">participant</span> <span class="nx">Alice</span>
<span class="nx">participant</span> <span class="nx">Bob</span>
<span class="nx">Alice</span><span class="o">-</span><span class="nx">John</span><span class="o">:</span> <span class="nx">Hello</span> <span class="nx">John</span><span class="p">,</span> <span class="nx">how</span> <span class="nx">are</span> <span class="nx">you</span><span class="o">?</span>
<span class="nx">loop</span> <span class="nx">Healthcheck</span>
<span class="nx">John</span><span class="o">-</span><span class="nx">John</span><span class="o">:</span> <span class="nx">Fight</span> <span class="nx">against</span> <span class="nx">hypochondria</span>
<span class="nx">end</span>
<span class="nx">Note</span> <span class="nx">right</span> <span class="nx">of</span> <span class="nx">John</span><span class="o">:</span> <span class="nx">Rational</span> <span class="nx">thoughts</span> <span class="nx">lt</span><span class="p">;</span><span class="nx">br</span><span class="o">/</span><span class="nx">prevail</span><span class="p">...</span>
<span class="nx">John</span><span class="o">--</span><span class="nx">Alice</span><span class="o">:</span> <span class="nx">Great</span><span class="o">!</span>
<span class="nx">John</span><span class="o">-</span><span class="nx">Bob</span><span class="o">:</span> <span class="nx">How</span> <span class="nx">about</span> <span class="nx">you</span><span class="o">?</span>
<span class="nx">Bob</span><span class="o">--</span><span class="nx">John</span><span class="o">:</span> <span class="nx">Jolly</span> <span class="nx">good</span><span class="o">!</span>
</code></pre></div>
<div class="highlight"><pre><code><span class="o">%%</span> <span class="nx">Example</span> <span class="nx">of</span> <span class="nx">a</span> <span class="nx">Gannt</span> <span class="nx">diagram</span>
<span class="nx">gantt</span>
<span class="nx">dateFormat</span> <span class="nx">YYYY</span><span class="o">-</span><span class="nx">MM</span><span class="o">-</span><span class="nx">DD</span>
<span class="nx">title</span> <span class="nx">Adding</span> <span class="nx">GANTT</span> <span class="nx">diagram</span> <span class="nx">functionality</span> <span class="nx">to</span> <span class="nx">mermaid</span>
<span class="nx">section</span> <span class="nx">A</span> <span class="nx">section</span>
<span class="nx">Completed</span> <span class="nx">task</span> <span class="o">:</span><span class="nx">done</span><span class="p">,</span> <span class="nx">des1</span><span class="p">,</span> <span class="mi">2014</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">06</span><span class="p">,</span><span class="mi">2014</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">08</span>
<span class="nx">Active</span> <span class="nx">task</span> <span class="o">:</span><span class="nx">active</span><span class="p">,</span> <span class="nx">des2</span><span class="p">,</span> <span class="mi">2014</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">09</span><span class="p">,</span> <span class="mi">3</span><span class="nx">d</span>
<span class="nx">Future</span> <span class="nx">task</span> <span class="o">:</span> <span class="nx">des3</span><span class="p">,</span> <span class="nx">after</span> <span class="nx">des2</span><span class="p">,</span> <span class="mi">5</span><span class="nx">d</span>
<span class="nx">Future</span> <span class="nx">task2</span> <span class="o">:</span> <span class="nx">des4</span><span class="p">,</span> <span class="nx">after</span> <span class="nx">des3</span><span class="p">,</span> <span class="mi">5</span><span class="nx">d</span>
<span class="nx">section</span> <span class="nx">Critical</span> <span class="nx">tasks</span>
<span class="nx">Completed</span> <span class="nx">task</span> <span class="k">in</span> <span class="nx">the</span> <span class="nx">critical</span> <span class="nx">line</span> <span class="o">:</span><span class="nx">crit</span><span class="p">,</span> <span class="nx">done</span><span class="p">,</span> <span class="mi">2014</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">06</span><span class="p">,</span><span class="mi">24</span><span class="nx">h</span>
<span class="nx">Implement</span> <span class="nx">parser</span> <span class="nx">and</span> <span class="nx">jison</span> <span class="o">:</span><span class="nx">crit</span><span class="p">,</span> <span class="nx">done</span><span class="p">,</span> <span class="nx">after</span> <span class="nx">des1</span><span class="p">,</span> <span class="mi">2</span><span class="nx">d</span>
<span class="nx">Create</span> <span class="nx">tests</span> <span class="k">for</span> <span class="nx">parser</span> <span class="o">:</span><span class="nx">crit</span><span class="p">,</span> <span class="nx">active</span><span class="p">,</span> <span class="mi">3</span><span class="nx">d</span>
<span class="nx">Future</span> <span class="nx">task</span> <span class="k">in</span> <span class="nx">critical</span> <span class="nx">line</span> <span class="o">:</span><span class="nx">crit</span><span class="p">,</span> <span class="mi">5</span><span class="nx">d</span>
<span class="nx">Create</span> <span class="nx">tests</span> <span class="k">for</span> <span class="nx">renderer</span> <span class="o">:</span><span class="mi">2</span><span class="nx">d</span>
<span class="nx">Add</span> <span class="nx">to</span> <span class="nx">mermaid</span> <span class="o">:</span><span class="mi">1</span><span class="nx">d</span>
</code></pre></div>
<p>Play with mermaid using this <a href="http://danielmschmidt.github.io/mermaid-demo/">editor</a> or this <a href="live_editor">live editor</a>. You can also look at mermaid in action using <a href="http://jsbin.com/faxunexeku/1/edit?html,output">jsbin</a>.</p>
<div class="pilwrap" id="Further reading">
<h2>
<a href="#Further reading" name="Further reading" class="pilcrow">¶</a>
Further reading</h2>
</div>
<ul>
<li><a href="http://knsv.github.io/mermaid/usage.html">Usage</a></li>
<li><a href="http://knsv.github.io/mermaid/flowchart.html">Flowchart syntax</a></li>
<li><a href="http://knsv.github.io/mermaid/sequenceDiagram.html">Sequence diagram syntax</a></li>
<li><a href="http://knsv.github.io/mermaid/gantt.html">Gantt chart syntax</a></li>
<li><a href="http://knsv.github.io/mermaid/mermaidCLI.html">Mermaid client</a></li>
<li><a href="http://knsv.github.io/mermaid/live_editor">Editor</a></li>
</ul>
<div class="pilwrap" id="Credits">
<h1>
<a href="#Credits" name="Credits" class="pilcrow">¶</a>
Credits</h1>
</div>
<p>Many thanks to the <a href="http://d3js.org/">d3</a> and <a href="https://github.com/cpettitt/dagre-d3">dagre-d3</a> projects for providing
the graphical layout and drawing libraries! Thanks also to the
<a href="http://bramp.github.io/js-sequence-diagrams">js-sequence-diagram</a> project for usage of the grammar for the
sequence diagrams.</p>
<p><em>Mermaid was created by Knut Sveidqvist for easier documentation.</em></p>
<p>Knut has not done all work by himself, here is the full list of the projects <a href="https://github.com/knsv/mermaid/graphs/contributors">contributors</a>.</p>
</div>
</div>
</body>
</html>