UNPKG

mermaid

Version:

Markdownish syntax for generating flowcharts, sequence diagrams and gantt charts.

117 lines (110 loc) 10.4 kB
<!DOCTYPE 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">&#182;</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">&#182;</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">&#182;</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>