diff --git a/.github/gh-pages-publish.yml b/.github/gh-pages-publish.yml
index de87e6a3b..4a5fc4d95 100644
--- a/.github/gh-pages-publish.yml
+++ b/.github/gh-pages-publish.yml
@@ -18,4 +18,4 @@ jobs:
         uses: JamesIves/github-pages-deploy-action@v4.3.3
         with:
           branch: gh-pages # The branch the action should deploy to.
-          folder: packages/mermaid/docs/.vitepress/dist # The folder the action should deploy.
+          folder: packages/mermaid/src/docs/.vitepress/dist # The folder the action should deploy.
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index f316c47c7..a7ad03a7a 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -5,12 +5,12 @@ on:
     branches:
       - develop
     paths:
-      - 'packages/mermaid/docs/**/*'
+      - 'packages/mermaid/src/docs/**/*'
   pull_request:
     branches:
       - develop
     paths:
-      - 'packages/mermaid/docs/**/*'
+      - 'packages/mermaid/src/docs/**/*'
 jobs:
   spellcheck:
     name: 'Docs: Spellcheck'
@@ -24,5 +24,5 @@ jobs:
           node-version: '16'
       - run: npm install -g cspell
         name: Install cSpell
-      - run: cspell --config ./cSpell.json "packages/mermaid/docs/**/*.md" --no-progress
+      - run: cspell --config ./cSpell.json "packages/mermaid/src/docs/**/*.md" --no-progress
         name: Run cSpell
diff --git a/.gitignore b/.gitignore
index 433a9b05f..cdd33c2c5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -34,4 +34,4 @@ cypress/snapshots/
 tsconfig.tsbuildinfo
 
 #docs generate from code
-packages/mermaid/docs/config/setup
\ No newline at end of file
+packages/mermaid/src/docs/config/setup
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 843e19fd9..cf567a97d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -32,7 +32,7 @@ We make all changes via pull requests. As we have many pull requests from develo
 
 - Large changes reviewed by knsv or other developer asked to review by knsv
 - Smaller low-risk changes like dependencies, documentation, etc. can be merged by active collaborators
-- Documentation (updates to the `package/mermaid/docs` folder is also allowed via direct commits)
+- Documentation (updates to the `package/mermaid/src/docs` folder is also allowed via direct commits)
 
 To commit code, create a branch, let it start with the type like feature or bug followed by the issue number for reference and some describing text.
 
@@ -50,16 +50,16 @@ Less strict here, it is OK to commit directly in the `develop` branch if you are
 
 The documentation is written in **Markdown**. For more information about Markdown [see the GitHub Markdown help page](https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax).
 
-### Documentation source files are in [`/packages/mermaid/docs`](packages/mermaid/docs)
+### Documentation source files are in [`/packages/mermaid/src/docs`](packages/mermaid/src/docs)
 
-The source files for the project documentation are located in the [`/packages/mermaid/docs`](packages/mermaid/docs) directory. This is where you should make changes.
-The files under `/packages/mermaid/docs` are processed to generate the published documentation, and the resulting files are put into the `/docs` directory.
+The source files for the project documentation are located in the [`/packages/mermaid/src/docs`](packages/mermaid/src/docs) directory. This is where you should make changes.
+The files under `/packages/mermaid/src/docs` are processed to generate the published documentation, and the resulting files are put into the `/docs` directory.
 
 ```mermaid
 flowchart LR
   classDef default fill:#fff,color:black,stroke:black
 
-  source["files in /packages/mermaid/docs\n(changes should be done here)"] -- automatic processing\nto generate the final documentation--> published["files in /docs\ndisplayed on the official documentation site"]
+  source["files in /packages/mermaid/src/docs\n(changes should be done here)"] -- automatic processing\nto generate the final documentation--> published["files in /docs\ndisplayed on the official documentation site"]
 
 ```
 
@@ -148,7 +148,7 @@ it('should render forks and joins', () => {
 
 Finally, if it is not in the documentation, no one will know about it and then **no one will use it**. Wouldn't that be sad? With all the effort that was put into the feature?
 
-The source files for documentation are in `/packages/mermaid/docs` and are written in markdown. Just pick the right section and start typing. See the [Committing Documentation](#committing-documentation) section for more about how the documentation is generated.
+The source files for documentation are in `/packages/mermaid/src/docs` and are written in markdown. Just pick the right section and start typing. See the [Committing Documentation](#committing-documentation) section for more about how the documentation is generated.
 
 #### Adding to or changing the documentation organization
 
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 4597de900..121c4de75 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -1,4 +1,4 @@
-import { version } from '../../package.json';
+import { version } from '../../../package.json';
 import MermaidMarkdown from './mermaid-markdown-all';
 import { defineConfig } from 'vitepress';
 
@@ -8,9 +8,12 @@ export default defineConfig({
   description: 'Create diagrams and visualizations using text and code.',
   base: '/mermaid-docs/',
   markdown: MermaidMarkdown,
-  ignoreDeadLinks: true, //TODO: try to fixe those in autogenerated docs
   themeConfig: {
     nav: nav(),
+    editLink: {
+      pattern: 'https://github.com/mermaid-js/mermaid/edit/develop/docs/:path',
+      text: 'Edit this page on GitHub',
+    },
 
     sidebar: {
       '/': sidebarAll(),
@@ -53,7 +56,7 @@ function nav() {
     },
     {
       text: '💻 Live Editor',
-      link: '/edit',
+      link: 'https://mermaid.live',
     },
   ];
 }
diff --git a/docs/.vitepress/theme/custom.css b/docs/.vitepress/theme/custom.css
index d42052792..8d5b71f56 100644
--- a/docs/.vitepress/theme/custom.css
+++ b/docs/.vitepress/theme/custom.css
@@ -1,13 +1,17 @@
-@media (min-width: 1440px) {
-  .VPDoc:not(.has-sidebar) .container[data-v-10119189] {
-    max-width: 100%;
-  }
-
-  .VPDoc.has-aside .content-container[data-v-10119189] {
-    max-width: 100%;
-  }
+:root {
+  --vp-c-brand: #ff3670;
+  --vp-c-brand-light: #ff5e8c;
+  --vp-c-brand-lighter: #ff85a8;
+  --vp-c-brand-lightest: #ff9bb7;
+  --vp-c-brand-dark: #bd34fe;
+  --vp-c-brand-darker: #9339bd;
+  --vp-c-brand-dimm: rgba(100, 108, 255, 0.08);
 }
 
 :root {
-  --vp-layout-max-width: 100%;
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe 30%, #ff3670);
+
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #bd34fe 50%, #ff3670 50%);
+  --vp-home-hero-image-filter: blur(72px);
 }
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index 7093a1643..bcce341a2 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -1,4 +1,5 @@
 import DefaultTheme from 'vitepress/theme';
+// @ts-ignore
 import Mermaid from 'vitepress-plugin-mermaid/Mermaid.vue';
 import './custom.css';
 
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
new file mode 100644
index 000000000..859ceec23
--- /dev/null
+++ b/docs/CHANGELOG.md
@@ -0,0 +1,1050 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
+
+# Change Log
+
+All changes are in descending order, beginning with the newest (latest) version.
+
+## Unreleased
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/8.7.0...HEAD)
+
+## 8.7.0 (2020-08-09)
+
+🔖 [Release Notes](https://github.com/mermaid-js/mermaid/releases/tag/8.7.0) |
+📜 [Full Changelog](https://github.com/mermaid-js/mermaid/compare/8.6.0...8.7.0)
+
+This version brings with it a system for [dynamic and integrated configuration of the diagram themes](../config/theming.md).
+The objective of this is to increase the customizability of mermaid and the ease of Styling, with the customization of themes through the `%%init%%` directive and `initialize` calls.
+
+Themes follow and build upon the Levels of Configuration and employ `directives` to modify and create custom configurations, as they were introduced in Version [8.6.0](../getting-started/8.6.0_docs.md).
+
+**These Theming Configurations, similar to directives, will also be made applicable in the Live-Editor, for easier styling.**
+
+### Site-wide Themes
+
+Site-wide themes are still declared via `initialize` by site owners.
+
+Example of `Initalize` call setting `theme` to `base`:
+
+```javascript
+mermaidAPI.initialize({
+  securityLevel: 'loose',
+  theme: 'base',
+});
+```
+
+**Notes**: Only site owners can use the `mermaidAPI.initialize` call, to set values. Site-Users will have to use `%%init%%` to modify or create the theme for their diagrams.
+
+### Themes at the Local or Current Level
+
+When Generating a diagram using on a webpage that supports mermaid.
+It is also possible to override site-wide theme settings locally, for a specific diagram, using directives, as long as it is not prohibited by the `secure` array.
+
+**Following is an example:**
+
+```mermaid-example
+%%{init: {'theme':'base'}}%%
+  graph TD
+    a --> b
+```
+
+```mermaid
+%%{init: {'theme':'base'}}%%
+  graph TD
+    a --> b
+```
+
+### Making a Custom Theme with `themeVariables`
+
+The easiest way to make a custom theme is to start with the base theme, and just modify theme variables through `themeVariables`, via `%%init%%`.
+
+| Parameter      | Description                                                        | Type  | Required | Objects contained                  |
+| -------------- | ------------------------------------------------------------------ | ----- | -------- | ---------------------------------- |
+| themeVariables | Array containing objects, modifiable with the `%%init%%` directive | Array | Required | primaryColor, lineColor, textColor |
+
+Here is an example of overriding `primaryColor` and giving everything a different look, using `%%init%%`.
+
+```mermaid-example
+%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
+        graph TD
+          A[Christmas] -->|Get money| B(Go shopping)
+          B --> C{Let me think}
+          B --> G[/Another/]
+          C ==>|One| D[Laptop]
+          C -->|Two| E[iPhone]
+          C -->|Three| F[fa:fa-car Car]
+          subgraph section
+            C
+            D
+            E
+            F
+            G
+          end
+```
+
+```mermaid
+%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
+        graph TD
+          A[Christmas] -->|Get money| B(Go shopping)
+          B --> C{Let me think}
+          B --> G[/Another/]
+          C ==>|One| D[Laptop]
+          C -->|Two| E[iPhone]
+          C -->|Three| F[fa:fa-car Car]
+          subgraph section
+            C
+            D
+            E
+            F
+            G
+          end
+```
+
+**Notes:**
+Leaving it empty will set all variable values to default.
+
+## 8.6.0 (2020-07-13)
+
+🔖 [Release Notes](https://github.com/mermaid-js/mermaid/releases/tag/8.6.0)
+
+[Version 8.6.0](../getting-started/8.6.0_docs.md) introduces New Configuration Protocols and Directives and a Beta for the [New Mermaid Live-Editor](https://mermaid-js.github.io/docs/mermaid-live-editor-beta/#/edit/eyJjb2RlIjoiJSV7aW5pdDoge1widGhlbWVcIjogXCJmb3Jlc3RcIiwgXCJsb2dMZXZlbFwiOiAxIH19JSVcbmdyYXBoIFREXG4gIEFbQ2hyaXN0bWFzXSAtLT58R2V0IG1vbmV5fCBCKEdvIHNob3BwaW5nKVxuICBCIC0tPiBDe0xldCBtZSB0aGlua31cbiAgQyAtLT58T25lfCBEW0xhcHRvcF1cbiAgQyAtLT58VHdvfCBFW2lQaG9uZV1cbiAgQyAtLT58VGhyZWV8IEZbZmE6ZmEtY2FyIENhcl1cblx0XHQiLCJtZXJtYWlkIjp7InRoZW1lIjoiZGFyayJ9fQ)
+
+**With version 8.6.0 comes the release of directives for mermaid, a new system for modifying configurations, with the aim of establishing centralized, sane defaults and simple implementation.**
+
+Directives allow for a diagram specific overriding of config, as it has been discussed in Configurations.
+This allows site users to input modifications to config alongside diagram definitions, when creating diagrams on a private webpage that supports Mermaid.
+
+## 8.5.0 (2020-04-11)
+
+🔖 [Release Notes](https://github.com/mermaid-js/mermaid/releases/tag/untagged-31c93788afe260d914bb)
+
+This version introduces New diagrams!
+
+**New diagrams in 8.5**
+
+With version 8.5 there are some bug fixes and enhancements, plus a new diagram type, entity relationship diagrams.
+
+![Image showing the new ER diagram type](./img/er.png)
+
+## 8.2.0 (2019-07-17)
+
+🏷️ [Tag](https://github.com/mermaid-js/mermaid/tree/8.2.0)
+
+Version 8.2.0, introduces a security improvement.
+
+A `securityLevel` configuration has to first be cleared, `securityLevel` sets the level of trust for the parsed diagrams and limits click functionality.
+This was introduced in version 8.2 as a security improvement, aimed at preventing malicious use.
+
+### securityLevel
+
+| Parameter     | Description                       | Type   | Required | Values                    |
+| ------------- | --------------------------------- | ------ | -------- | ------------------------- |
+| securitylevel | Level of trust for parsed diagram | String | Required | Strict, Loose, antiscript |
+
+**Notes:**
+
+- **strict**: (**default**) tags in text are encoded, click functionality is disabled
+- **loose**: tags in text are allowed, click functionality is enabled
+- **antiscript**: html tags in text are allowed, (only script element is removed), click functionality is enabled
+
+⚠️ **Note**: This changes the default behaviour of mermaid so that after upgrade to 8.2, if the `securityLevel` is not configured, tags in flowcharts are encoded as tags and clicking is prohibited.
+
+If you are taking responsibility for the diagram source security you can set the `securityLevel` to a value of your choosing.
+By doing this clicks and tags are again allowed.
+
+### To change `securityLevel` with `mermaidAPI.initialize`:
+
+```javascript
+mermaidAPI.initialize({
+  securityLevel: 'loose',
+});
+```
+
+**Closed issues:**
+
+- please add tag for 8.0.0 release [#863](https://github.com/knsv/mermaid/issues/863)
+- classDiagram breaks on any edit [#858](https://github.com/knsv/mermaid/issues/858)
+
+## [8.1.0](https://github.com/knsv/mermaid/tree/8.1.0) (2019-06-25)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/7.0.5...8.1.0)
+
+**Implemented enhancements:**
+
+- Theme for dark background [#301](https://github.com/knsv/mermaid/issues/301)
+- \[Feature request] gantt diagram axis format [#269](https://github.com/knsv/mermaid/issues/269)
+- Implement render function for server side rendering using phantomjs [#169](https://github.com/knsv/mermaid/issues/169)
+
+**Fixed bugs:**
+
+- mermaid -v filename.mmd gives You must specify at least one source file. [#328](https://github.com/knsv/mermaid/issues/328)
+- Not Able to See Labels even htmlLabels:false added [#268](https://github.com/knsv/mermaid/issues/268)
+
+**Closed issues:**
+
+- Gantt and sequence diagram do not render [#853](https://github.com/knsv/mermaid/issues/853)
+- margins around flowchart are not balanced [#852](https://github.com/knsv/mermaid/issues/852)
+- Smaller bundles [#843](https://github.com/knsv/mermaid/issues/843)
+- unicode in labels [#776](https://github.com/knsv/mermaid/issues/776)
+- Hard-changing drawing of arrows per edge type [#775](https://github.com/knsv/mermaid/issues/775)
+- SequenceDiagram wrong [#773](https://github.com/knsv/mermaid/issues/773)
+- Render mermaid on github pages with simple code [#772](https://github.com/knsv/mermaid/issues/772)
+- FlowChart - large space between text and the image [#754](https://github.com/knsv/mermaid/issues/754)
+- Class Diagram Issues when using Mermaid in Stackedit [#748](https://github.com/knsv/mermaid/issues/748)
+- Multi-platform CI [#744](https://github.com/knsv/mermaid/issues/744)
+- gantt: sections can't have a colon [#742](https://github.com/knsv/mermaid/issues/742)
+- Yarn build does not add mermaid.min.css to dist [#732](https://github.com/knsv/mermaid/issues/732)
+- Is there a grammar / keyword / more than just the basic examples? [#718](https://github.com/knsv/mermaid/issues/718)
+- Click event and react component [#717](https://github.com/knsv/mermaid/issues/717)
+- Long text going outside the box [#706](https://github.com/knsv/mermaid/issues/706)
+- How to migrate from yUML to mermaid? [#704](https://github.com/knsv/mermaid/issues/704)
+- Issue on Dynamic Creation in PHP [#690](https://github.com/knsv/mermaid/issues/690)
+- `click "\#target"` and `click "http://url"` should create regular links [#689](https://github.com/knsv/mermaid/issues/689)
+- Support Chinese punctuation [#687](https://github.com/knsv/mermaid/issues/687)
+- \[Question] Proper way to install on Mac? [#681](https://github.com/knsv/mermaid/issues/681)
+- Has Mermaid a graphical interface to make diagrams? [#668](https://github.com/knsv/mermaid/issues/668)
+- mermaid installation on debian [#649](https://github.com/knsv/mermaid/issues/649)
+- "Cannot activate" in sequenceDiagram [#647](https://github.com/knsv/mermaid/issues/647)
+- Link ("click" statement) in flowchart does not work in exported SVG [#646](https://github.com/knsv/mermaid/issues/646)
+- How to pass styling [#639](https://github.com/knsv/mermaid/issues/639)
+- The live editor cant show seq diagram with notes for 8.0.0-alpha.3 [#638](https://github.com/knsv/mermaid/issues/638)
+- import mermaid.css with ES6 + NPM [#634](https://github.com/knsv/mermaid/issues/634)
+- Actor line cuts through other elements [#633](https://github.com/knsv/mermaid/issues/633)
+- Graph TD line out of the picture (left side) [#630](https://github.com/knsv/mermaid/issues/630)
+- Flowchart labels appear "cutoff" [#628](https://github.com/knsv/mermaid/issues/628)
+- Uncaught TypeError: \_.constant is not a function (mermaid.js) [#626](https://github.com/knsv/mermaid/issues/626)
+- Missing tags and releases for newer versions [#623](https://github.com/knsv/mermaid/issues/623)
+- Mermaid and Leo / Leo Vue [#622](https://github.com/knsv/mermaid/issues/622)
+- mermaidAPI gantt Vue.js [#621](https://github.com/knsv/mermaid/issues/621)
+- Gantt sections are not separated by colors - Fix: set numberSectionStyles to 4 instead of 3 [#620](https://github.com/knsv/mermaid/issues/620)
+- how to get mermaidAPI? [#617](https://github.com/knsv/mermaid/issues/617)
+- Error in startOnLoad documentation? [#616](https://github.com/knsv/mermaid/issues/616)
+- Example export to SVG generates error [#614](https://github.com/knsv/mermaid/issues/614)
+- The new online editor does not support previously generated links [#613](https://github.com/knsv/mermaid/issues/613)
+- Grammar / Syntax documentation for flowcharts [#607](https://github.com/knsv/mermaid/issues/607)
+- Mermaid does not work with d3.js [#606](https://github.com/knsv/mermaid/issues/606)
+- Why does this code's flowchart lines get cut-off on screen? [#604](https://github.com/knsv/mermaid/issues/604)
+- click keyword does not fire my callback (on the demo Website too) [#603](https://github.com/knsv/mermaid/issues/603)
+- Online Editor fails to show exported SVG [#601](https://github.com/knsv/mermaid/issues/601)
+- Just saying thanks! [#597](https://github.com/knsv/mermaid/issues/597)
+- stylesheet crashed with other library like abcjs [#596](https://github.com/knsv/mermaid/issues/596)
+- Missing connection [#594](https://github.com/knsv/mermaid/issues/594)
+- How to use mermaid on node.js restful api? [#593](https://github.com/knsv/mermaid/issues/593)
+- Remove status code [#589](https://github.com/knsv/mermaid/issues/589)
+- Golang based editor [#588](https://github.com/knsv/mermaid/issues/588)
+- sequenceDiagram -> notetext css font is hardcoded [#587](https://github.com/knsv/mermaid/issues/587)
+- Multiple graph in the live editor [#586](https://github.com/knsv/mermaid/issues/586)
+- All \<svg> elements in page are colored black [#584](https://github.com/knsv/mermaid/issues/584)
+- Styling: classes aren't applied to elements. [#582](https://github.com/knsv/mermaid/issues/582)
+- Rounded connections [#580](https://github.com/knsv/mermaid/issues/580)
+- Arrows are not being shown correctly in the dark theme [#578](https://github.com/knsv/mermaid/issues/578)
+- The documentation for CLI seems outdated. [#572](https://github.com/knsv/mermaid/issues/572)
+- No effect of click event:can not open link [#571](https://github.com/knsv/mermaid/issues/571)
+- Text colors are not correct in VSCODE [#570](https://github.com/knsv/mermaid/issues/570)
+- Nodes aren't aligned properly (just need an explanation) [#568](https://github.com/knsv/mermaid/issues/568)
+- setting margin around figure in R [#567](https://github.com/knsv/mermaid/issues/567)
+- Arrows should Come out in upward and Downward direction from decision Node [#566](https://github.com/knsv/mermaid/issues/566)
+- TypeError: Cannot read property 'select' of undefined [#563](https://github.com/knsv/mermaid/issues/563)
+- A little bug [#557](https://github.com/knsv/mermaid/issues/557)
+- Japanese text appears garbled [#554](https://github.com/knsv/mermaid/issues/554)
+- classdiagram not works in mermaid live_editor [#553](https://github.com/knsv/mermaid/issues/553)
+- font awesome in link text? [#546](https://github.com/knsv/mermaid/issues/546)
+- q: heard of the cosmogol standard? [#545](https://github.com/knsv/mermaid/issues/545)
+- Arrow heads missing (cli, 7.0.3) [#544](https://github.com/knsv/mermaid/issues/544)
+- No Edge Boxes if useHtmlLabels=false [#541](https://github.com/knsv/mermaid/issues/541)
+- how to change mermaid text color or line text block color？ [#534](https://github.com/knsv/mermaid/issues/534)
+- FlowChart visualization broken when downloading from live editor [#533](https://github.com/knsv/mermaid/issues/533)
+- Can't get flowchart to render paths at the top of the diagram; I even tried the online editor and that shows the same issue. Thoughts? [#532](https://github.com/knsv/mermaid/issues/532)
+- live editor make browser(safari on macOS\&iOS) not longer respond [#531](https://github.com/knsv/mermaid/issues/531)
+- css classes need a prefix/namespace [#527](https://github.com/knsv/mermaid/issues/527)
+- input activate/deactivate cause safari unresponding [#521](https://github.com/knsv/mermaid/issues/521)
+- Cannot Render the Mermaid Graph to PDF ? [#520](https://github.com/knsv/mermaid/issues/520)
+- clicking links works from inset in subgraph but not from nodes [#516](https://github.com/knsv/mermaid/issues/516)
+- Strange syntax error - when importing mermaid.js [#515](https://github.com/knsv/mermaid/issues/515)
+- gantt x-axis display [#510](https://github.com/knsv/mermaid/issues/510)
+- phantomjs renamed to phantomjs-prebuilt [#508](https://github.com/knsv/mermaid/issues/508)
+- issue when using sphinxcontrib-mermaid extension for sphinx [#507](https://github.com/knsv/mermaid/issues/507)
+- layout of docs page looks broken [#504](https://github.com/knsv/mermaid/issues/504)
+- Problem showing graph with php on localhost [#502](https://github.com/knsv/mermaid/issues/502)
+- logLevel's option doesn't work at 7.0.0 [#501](https://github.com/knsv/mermaid/issues/501)
+- How do I get the log for a render or parse attempt? [#500](https://github.com/knsv/mermaid/issues/500)
+- Mermaid neutral style style to built in latest release [#499](https://github.com/knsv/mermaid/issues/499)
+- Any plans for adding a typescript definition file? [#495](https://github.com/knsv/mermaid/issues/495)
+- Gantt diagrams too narrow [#493](https://github.com/knsv/mermaid/issues/493)
+- Flowchart edge labels placement [#490](https://github.com/knsv/mermaid/issues/490)
+- Very different styles when rendering as png vs. svg [#489](https://github.com/knsv/mermaid/issues/489)
+- New editor that supports mermaid: Caret [#488](https://github.com/knsv/mermaid/issues/488)
+- Gant PNG margin [#486](https://github.com/knsv/mermaid/issues/486)
+- ReferenceError: window is not defined [#485](https://github.com/knsv/mermaid/issues/485)
+- Menu and layout bugs in docs [#484](https://github.com/knsv/mermaid/issues/484)
+- Mermaid resets some of the page CSS styles [#482](https://github.com/knsv/mermaid/issues/482)
+- Arrows rendering incorrectly in online editor [#480](https://github.com/knsv/mermaid/issues/480)
+- CSS stroke-dasharray ignored by browsers but not other viewers [#474](https://github.com/knsv/mermaid/issues/474)
+- mermaid - Browser Support issue [#472](https://github.com/knsv/mermaid/issues/472)
+- Totally love mermaid I might pop! [#471](https://github.com/knsv/mermaid/issues/471)
+- Sequence Diagram: Missing x on async arrows (png) [#469](https://github.com/knsv/mermaid/issues/469)
+- live editor: the svg file rendered from graph is not supported by browsers [#468](https://github.com/knsv/mermaid/issues/468)
+- Not found css [#462](https://github.com/knsv/mermaid/issues/462)
+- Phantomjs Dependency [#461](https://github.com/knsv/mermaid/issues/461)
+- Mermaid cli not working for subgraphs [#459](https://github.com/knsv/mermaid/issues/459)
+- Support for notes across multiple participants? [#458](https://github.com/knsv/mermaid/issues/458)
+- Related to Issue #329: Phantomjs issues. [#455](https://github.com/knsv/mermaid/issues/455)
+- Add a click style [#426](https://github.com/knsv/mermaid/issues/426)
+- Add Parallel block (par) to sequence diagrams [#425](https://github.com/knsv/mermaid/issues/425)
+- updating shapes after the flow chart rendering complete [#424](https://github.com/knsv/mermaid/issues/424)
+- can't catch parse error Maximum call stack size exceeded on safari [#421](https://github.com/knsv/mermaid/issues/421)
+- Arrows endings are missing [#419](https://github.com/knsv/mermaid/issues/419)
+- shouldn't mermaid become more like Markdown ? [#417](https://github.com/knsv/mermaid/issues/417)
+- Live editor show rendered diagram if syntax invalid [#415](https://github.com/knsv/mermaid/issues/415)
+- Linkstyle stroke does not work [#410](https://github.com/knsv/mermaid/issues/410)
+- flowchart id's with dots in them .. break links [#408](https://github.com/knsv/mermaid/issues/408)
+- Flowchart: Link text beginning with lowercase 'o' causes flowchart to break [#407](https://github.com/knsv/mermaid/issues/407)
+- Some Chinese character will case Safari no responding. [#405](https://github.com/knsv/mermaid/issues/405)
+- Cannot center-justify text in nodes? [#397](https://github.com/knsv/mermaid/issues/397)
+- Edge labels should have white background in live editor [#396](https://github.com/knsv/mermaid/issues/396)
+- Live editor does not support activate/deactivate [#394](https://github.com/knsv/mermaid/issues/394)
+- Styling subgraph? [#391](https://github.com/knsv/mermaid/issues/391)
+- Update live editor to version 6.0.0 [#387](https://github.com/knsv/mermaid/issues/387)
+- sequence diagram config issue [#385](https://github.com/knsv/mermaid/issues/385)
+- How to add newline in the text [#384](https://github.com/knsv/mermaid/issues/384)
+- PhantomJS crashes on a large graph [#380](https://github.com/knsv/mermaid/issues/380)
+- Finnish support for class diagrams using plantuml syntax [#377](https://github.com/knsv/mermaid/issues/377)
+- mermaidAPI.render generated different svg code from mermaid.int() [#374](https://github.com/knsv/mermaid/issues/374)
+- Put your own action on the chart [#372](https://github.com/knsv/mermaid/issues/372)
+- when declaring participants the elements are generated twice [#370](https://github.com/knsv/mermaid/issues/370)
+- Example Flowchart is cut in display (Chrome). [#368](https://github.com/knsv/mermaid/issues/368)
+- Add shebang support to diagrams [#365](https://github.com/knsv/mermaid/issues/365)
+- Silencing CLI output [#352](https://github.com/knsv/mermaid/issues/352)
+- SequenceDiagram: 3+ Alternative Paths [#348](https://github.com/knsv/mermaid/issues/348)
+- Smaller height of actor boxes [#342](https://github.com/knsv/mermaid/issues/342)
+- Question: lib/phantomscript.js - foreignObjects in SVG - related to #58 [#340](https://github.com/knsv/mermaid/issues/340)
+- npm test fails on osx being blocked at Can not load "PhantomJS", it is not registered! [#337](https://github.com/knsv/mermaid/issues/337)
+- Tabs & subgraphs cause rendering error [#336](https://github.com/knsv/mermaid/issues/336)
+- Display question: right angles [#335](https://github.com/knsv/mermaid/issues/335)
+- No Arrows rendered v0.5.8 [#330](https://github.com/knsv/mermaid/issues/330)
+- You had errors in your syntax. Use --help for further information. [#327](https://github.com/knsv/mermaid/issues/327)
+- Allow alternate arrow syntax that doesn't close html comments [#322](https://github.com/knsv/mermaid/issues/322)
+- Comment in subgraph [#319](https://github.com/knsv/mermaid/issues/319)
+- Update graph [#311](https://github.com/knsv/mermaid/issues/311)
+- css conflicts with boostrap's css [#308](https://github.com/knsv/mermaid/issues/308)
+- Can not get click event to fire. [#306](https://github.com/knsv/mermaid/issues/306)
+- Fix phantomjs2 compatibility [#304](https://github.com/knsv/mermaid/issues/304)
+- Flowcharts do not work in native IE11 [#303](https://github.com/knsv/mermaid/issues/303)
+- Integration with remark.js - tutorial added [#302](https://github.com/knsv/mermaid/issues/302)
+- Sequence diagram Loops: changing boxMargin spoils the "loop" notation [#299](https://github.com/knsv/mermaid/issues/299)
+- src/mermaid.js generates bad code [#297](https://github.com/knsv/mermaid/issues/297)
+- Fresh fork: jasmine tests fail [#294](https://github.com/knsv/mermaid/issues/294)
+- CSS clash [#292](https://github.com/knsv/mermaid/issues/292)
+- Mermaid does not work in Chrome 48 [#281](https://github.com/knsv/mermaid/issues/281)
+- circle and ellipse cannot change color by classDef [#271](https://github.com/knsv/mermaid/issues/271)
+- npm run watch doesn't work due missing dependencies [#266](https://github.com/knsv/mermaid/issues/266)
+- label out of node [#262](https://github.com/knsv/mermaid/issues/262)
+- IE11 Support issue [#261](https://github.com/knsv/mermaid/issues/261)
+- mermaid without browser [#260](https://github.com/knsv/mermaid/issues/260)
+- Insufficient capacity of gantt diagrams [#226](https://github.com/knsv/mermaid/issues/226)
+- some WARN about installation [#222](https://github.com/knsv/mermaid/issues/222)
+- Live editor offline access [#217](https://github.com/knsv/mermaid/issues/217)
+- suggest: code highlight mode config for editors [#212](https://github.com/knsv/mermaid/issues/212)
+- Uncaught RangeError: Maximum call stack size exceeded [#189](https://github.com/knsv/mermaid/issues/189)
+- Styling label texts [#50](https://github.com/knsv/mermaid/issues/50)
+
+**Merged pull requests:**
+
+- Remove console.log in classDB. [#861](https://github.com/knsv/mermaid/pull/861) ([Arthaey](https://github.com/Arthaey))
+- Bump sshpk from 1.13.1 to 1.16.1 [#851](https://github.com/knsv/mermaid/pull/851) ([dependabot\[bot\]](https://github.com/apps/dependabot))
+- Significantly smaller bundles [#850](https://github.com/knsv/mermaid/pull/850) ([fabiospampinato](https://github.com/fabiospampinato))
+- Support styling of subgraphs [#845](https://github.com/knsv/mermaid/pull/845) ([Qix-](https://github.com/Qix-))
+- fix dark theme loop labels not visible [#837](https://github.com/knsv/mermaid/pull/837) ([jnnnnn](https://github.com/jnnnnn))
+- fix draw function can only call once [#832](https://github.com/knsv/mermaid/pull/832) ([vaniship](https://github.com/vaniship))
+- Fix dotted lines not appearing in flowcharts when HTML labels disabled [#828](https://github.com/knsv/mermaid/pull/828) ([stanhu](https://github.com/stanhu))
+- Fix issue with XML line breaks inside vertex labels [#824](https://github.com/knsv/mermaid/pull/824) ([jsyang](https://github.com/jsyang))
+- fixed diagrams [#810](https://github.com/knsv/mermaid/pull/810) ([0xflotus](https://github.com/0xflotus))
+- Clickable gantt tasks [#804](https://github.com/knsv/mermaid/pull/804) ([abzicht](https://github.com/abzicht))
+- linkStyle now supports list of indexes with a few tests [#798](https://github.com/knsv/mermaid/pull/798) ([ivan-danilov](https://github.com/ivan-danilov))
+- fix class diagram mermaid [#795](https://github.com/knsv/mermaid/pull/795) ([DanShai](https://github.com/DanShai))
+- Added exclude weekdays to definition [#792](https://github.com/knsv/mermaid/pull/792) ([jopapo](https://github.com/jopapo))
+- SVG link rendering [#791](https://github.com/knsv/mermaid/pull/791) ([flying-sheep](https://github.com/flying-sheep))
+- Gantt milestones [#788](https://github.com/knsv/mermaid/pull/788) ([gijswijs](https://github.com/gijswijs))
+- Remove duplicate code [#768](https://github.com/knsv/mermaid/pull/768) ([znxkznxk1030](https://github.com/znxkznxk1030))
+- Render nodes as real links [#765](https://github.com/knsv/mermaid/pull/765) ([flying-sheep](https://github.com/flying-sheep))
+- Fix issue with marker-end. [#757](https://github.com/knsv/mermaid/pull/757) ([gjlubbertsen](https://github.com/gjlubbertsen))
+- Make Class Diagrams usable in Stackedit and Live Editor [#749](https://github.com/knsv/mermaid/pull/749) ([monsterkrampe](https://github.com/monsterkrampe))
+- Adding trapezoid and inverse trapezoid vertex options. [#741](https://github.com/knsv/mermaid/pull/741) ([adamwulf](https://github.com/adamwulf))
+- Add option for right angles [#721](https://github.com/knsv/mermaid/pull/721) ([paulbland](https://github.com/paulbland))
+- Add nested activation classes [#720](https://github.com/knsv/mermaid/pull/720) ([paulbland](https://github.com/paulbland))
+- wip: class diagram cardinality display [#705](https://github.com/knsv/mermaid/pull/705) ([Vrixyz](https://github.com/Vrixyz))
+- add comments about CSS in config [#688](https://github.com/knsv/mermaid/pull/688) ([imma90](https://github.com/imma90))
+- SequenceDiagram: Add support for multiple alt else statements [#641](https://github.com/knsv/mermaid/pull/641) ([sechel](https://github.com/sechel))
+- fix #426 - add class .clickable on nodes with click function or link [#598](https://github.com/knsv/mermaid/pull/598) ([thomasleveil](https://github.com/thomasleveil))
+- Spec fix 1 [#595](https://github.com/knsv/mermaid/pull/595) ([frankschmitt](https://github.com/frankschmitt))
+
+## [7.0.5](https://github.com/knsv/mermaid/tree/7.0.5) (2017-09-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/7.0.3...7.0.5)
+
+**Closed issues:**
+
+- live editor latin error after update [#560](https://github.com/knsv/mermaid/issues/560)
+- Simple full example in online documentation is broken [#558](https://github.com/knsv/mermaid/issues/558)
+- Graph No Arrow Head v7.0.3 [#543](https://github.com/knsv/mermaid/issues/543)
+- Conflict while using mermaid along with core-js [#512](https://github.com/knsv/mermaid/issues/512)
+- Export to pdf on website [#496](https://github.com/knsv/mermaid/issues/496)
+- New downstream project: Mermaid Preview for VSCode [#442](https://github.com/knsv/mermaid/issues/442)
+- Can't Zoom the flowchart ? [#399](https://github.com/knsv/mermaid/issues/399)
+- line labels are not rendered correctly in live editor [#366](https://github.com/knsv/mermaid/issues/366)
+- mermaid-loader [#361](https://github.com/knsv/mermaid/issues/361)
+- Are there any documentation or examples for classDiagram and gitGraph? [#359](https://github.com/knsv/mermaid/issues/359)
+- \# character broken in 0.5.8 [#347](https://github.com/knsv/mermaid/issues/347)
+- Documentation issue: CSS example is not visible [#345](https://github.com/knsv/mermaid/issues/345)
+- Include documentation for command line usage [#326](https://github.com/knsv/mermaid/issues/326)
+- Fresh fork: can't build dist [#296](https://github.com/knsv/mermaid/issues/296)
+- Invalid value for \<svg> attribute viewBox="0 0 -Infinity -Infinity" [#291](https://github.com/knsv/mermaid/issues/291)
+- Webpack require fails [#277](https://github.com/knsv/mermaid/issues/277)
+- New documentation - need improved logo [#216](https://github.com/knsv/mermaid/issues/216)
+
+## [7.0.3](https://github.com/knsv/mermaid/tree/7.0.3) (2017-06-04)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/7.0.2...7.0.3)
+
+**Closed issues:**
+
+- the documentation website is down [#539](https://github.com/knsv/mermaid/issues/539)
+- Good example of interactivity with mermaidAPI [#514](https://github.com/knsv/mermaid/issues/514)
+
+## [7.0.2](https://github.com/knsv/mermaid/tree/7.0.2) (2017-06-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/7.0.0...7.0.2)
+
+**Closed issues:**
+
+- CDN is not working [#511](https://github.com/knsv/mermaid/issues/511)
+- A sampe sequenceDiagram crashes mermaid-cli [#492](https://github.com/knsv/mermaid/issues/492)
+- Mermaid doesn't delete nodes when called multiple times [#491](https://github.com/knsv/mermaid/issues/491)
+- API crashes on 2nd render() call [#478](https://github.com/knsv/mermaid/issues/478)
+- sequenceDiagram: dotted line for alt and empty bracket should be hidden [#456](https://github.com/knsv/mermaid/issues/456)
+- SVG output (almost) not correct [#434](https://github.com/knsv/mermaid/issues/434)
+- How to set axisFormatter of gantt in mermaid CLI? [#428](https://github.com/knsv/mermaid/issues/428)
+- customizing link style with any color sets `fill` property to `black` instead of `none` [#416](https://github.com/knsv/mermaid/issues/416)
+- New line at the end of SVG file [#400](https://github.com/knsv/mermaid/issues/400)
+- CLI doesn't work [#389](https://github.com/knsv/mermaid/issues/389)
+- Can't render subgraphs with htmlLabels: false [#367](https://github.com/knsv/mermaid/issues/367)
+- Color arrowhead [#362](https://github.com/knsv/mermaid/issues/362)
+- CLI: Invisible text, lines in SVG output [#341](https://github.com/knsv/mermaid/issues/341)
+
+**Merged pull requests:**
+
+- Support Multi-line Actor Descriptions [#764](https://github.com/knsv/mermaid/pull/764) ([watsoncj](https://github.com/watsoncj))
+- Update Travis config [#538](https://github.com/knsv/mermaid/pull/538) ([tylerlong](https://github.com/tylerlong))
+- Fix spelling of 'you' in sequenceDiagram docs [#537](https://github.com/knsv/mermaid/pull/537) ([ctruelson](https://github.com/ctruelson))
+- Improve CLI output [#536](https://github.com/knsv/mermaid/pull/536) ([gibson042](https://github.com/gibson042))
+- Modernize mermaid [#524](https://github.com/knsv/mermaid/pull/524) ([tylerlong](https://github.com/tylerlong))
+- Modernize mermaid [#519](https://github.com/knsv/mermaid/pull/519) ([tylerlong](https://github.com/tylerlong))
+- Update CLI instructions [#509](https://github.com/knsv/mermaid/pull/509) ([filipedeschamps](https://github.com/filipedeschamps))
+- Add style for classDiagram to dark/default theme [#503](https://github.com/knsv/mermaid/pull/503) ([yudenzel](https://github.com/yudenzel))
+- Fix documentation for git graph. [#498](https://github.com/knsv/mermaid/pull/498) ([gomlgs](https://github.com/gomlgs))
+- Fix links in documentations [#497](https://github.com/knsv/mermaid/pull/497) ([saveman71](https://github.com/saveman71))
+- Update README.md with git graph sample [#481](https://github.com/knsv/mermaid/pull/481) ([raghur](https://github.com/raghur))
+- Fix misspelling of “another” [#479](https://github.com/knsv/mermaid/pull/479) ([stevenschobert](https://github.com/stevenschobert))
+- Fixed #456 sequenceDiagram: dotted line for alt and empty bracket sho… [#477](https://github.com/knsv/mermaid/pull/477) ([brookhong](https://github.com/brookhong))
+- Add viewbox attr to class diagram [#473](https://github.com/knsv/mermaid/pull/473) ([gnkm](https://github.com/gnkm))
+- add par statement to sequenceDiagram [#470](https://github.com/knsv/mermaid/pull/470) ([u-minor](https://github.com/u-minor))
+
+## [7.0.0](https://github.com/knsv/mermaid/tree/7.0.0) (2017-01-29)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/6.0.0...7.0.0)
+
+**Implemented enhancements:**
+
+- npm install -g mermaid does not install phantomjs [#329](https://github.com/knsv/mermaid/issues/329)
+- activation boxes [#313](https://github.com/knsv/mermaid/issues/313)
+
+**Closed issues:**
+
+- demos on io site not working [#466](https://github.com/knsv/mermaid/issues/466)
+- Can not be generated PNG pictures through CLI with Chinese [#451](https://github.com/knsv/mermaid/issues/451)
+- Round nodes cannot be styled with CSS classes [#443](https://github.com/knsv/mermaid/issues/443)
+- webpack gulp UglifyJsPlugin error. [#440](https://github.com/knsv/mermaid/issues/440)
+- String concatenation isn't working [#432](https://github.com/knsv/mermaid/issues/432)
+- text flow/wrap in actor box of sequence diagram [#422](https://github.com/knsv/mermaid/issues/422)
+- Online live editor still use old version [#402](https://github.com/knsv/mermaid/issues/402)
+- uncaught TypeError: t.getTransformToElement is not a function [#401](https://github.com/knsv/mermaid/issues/401)
+- Only works when using browserify'd code [#373](https://github.com/knsv/mermaid/issues/373)
+- document the use of shebang line in mmd files [#364](https://github.com/knsv/mermaid/issues/364)
+- Diagrams are small and unreadable in IE 11 - since 0.5.1 [#356](https://github.com/knsv/mermaid/issues/356)
+- \[Feature Request] ER-Diagram Support [#354](https://github.com/knsv/mermaid/issues/354)
+- The need for mermaid.css should be mentioned explicitly in the intro docs... [#273](https://github.com/knsv/mermaid/issues/273)
+
+**Merged pull requests:**
+
+- Update index.html [#465](https://github.com/knsv/mermaid/pull/465) ([bmsleight](https://github.com/bmsleight))
+- Fix for #416, customizing link style with any color sets `fill` property to `black` instead of `none` [#452](https://github.com/knsv/mermaid/pull/452) ([joshuacolvin](https://github.com/joshuacolvin))
+- Allow .node>circle to receive css styles [#449](https://github.com/knsv/mermaid/pull/449) ([bfriedz](https://github.com/bfriedz))
+- Fix spelling [#447](https://github.com/knsv/mermaid/pull/447) ([jawn](https://github.com/jawn))
+- added tests and fix cli css style selector lowercase problem [#445](https://github.com/knsv/mermaid/pull/445) ([whyzdev](https://github.com/whyzdev))
+- Update d3.js [#441](https://github.com/knsv/mermaid/pull/441) ([hetz](https://github.com/hetz))
+- added tests to reproduce #434 in flowchart [#439](https://github.com/knsv/mermaid/pull/439) ([whyzdev](https://github.com/whyzdev))
+- Code Climate config [#437](https://github.com/knsv/mermaid/pull/437) ([larkinscott](https://github.com/larkinscott))
+- fix gantt and sequence digram cli cfg [#435](https://github.com/knsv/mermaid/pull/435) ([whyzdev](https://github.com/whyzdev))
+- fix gantt chart cli configuration broken [#433](https://github.com/knsv/mermaid/pull/433) ([whyzdev](https://github.com/whyzdev))
+- fix gantt chart cli configuration parsing including functions [#430](https://github.com/knsv/mermaid/pull/430) ([whyzdev](https://github.com/whyzdev))
+- Uses an empty text node instead of a string for svg group labels [#429](https://github.com/knsv/mermaid/pull/429) ([daveaglick](https://github.com/daveaglick))
+- use tspan via d3.textwrap to place actor text in sequence diagram [#427](https://github.com/knsv/mermaid/pull/427) ([whyzdev](https://github.com/whyzdev))
+- \#422 use foreignObject/div to place actor label in sequence diagram [#423](https://github.com/knsv/mermaid/pull/423) ([whyzdev](https://github.com/whyzdev))
+- Clarify the need for a CSS stylesheet [#413](https://github.com/knsv/mermaid/pull/413) ([sifb](https://github.com/sifb))
+- Added hads downstream project [#412](https://github.com/knsv/mermaid/pull/412) ([sinedied](https://github.com/sinedied))
+- update usage and fix #273 [#406](https://github.com/knsv/mermaid/pull/406) ([jinntrance](https://github.com/jinntrance))
+- Add https://github.com/raghur/mermaid-filter to downstream projects docs page [#404](https://github.com/knsv/mermaid/pull/404) ([raghur](https://github.com/raghur))
+- New neutral theme [#395](https://github.com/knsv/mermaid/pull/395) ([sinedied](https://github.com/sinedied))
+- fix cli issues [#390](https://github.com/knsv/mermaid/pull/390) ([ben-page](https://github.com/ben-page))
+- Add missing space for 'Labels out of bounds' section [#386](https://github.com/knsv/mermaid/pull/386) ([The-Alchemist](https://github.com/The-Alchemist))
+- Fix typo: `pats` -> `paths` [#382](https://github.com/knsv/mermaid/pull/382) ([swhgoon](https://github.com/swhgoon))
+- Added class diagram example to README.md [#379](https://github.com/knsv/mermaid/pull/379) ([HustLion](https://github.com/HustLion))
+- override normal flowchart arrowhead to allow css styling [#376](https://github.com/knsv/mermaid/pull/376) ([dodoinblue](https://github.com/dodoinblue))
+- added sphinx extension [#371](https://github.com/knsv/mermaid/pull/371) ([mgaitan](https://github.com/mgaitan))
+- Fix typo in the sequence diagram documentation [#369](https://github.com/knsv/mermaid/pull/369) ([ggpasqualino](https://github.com/ggpasqualino))
+
+## [6.0.0](https://github.com/knsv/mermaid/tree/6.0.0) (2016-05-29)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.8...6.0.0)
+
+**Closed issues:**
+
+- Docs css: code hard to read [#324](https://github.com/knsv/mermaid/issues/324)
+- About Markpad integration [#323](https://github.com/knsv/mermaid/issues/323)
+- How to link backwards in flowchart? [#321](https://github.com/knsv/mermaid/issues/321)
+- Help with editor [#310](https://github.com/knsv/mermaid/issues/310)
+- \+1 [#293](https://github.com/knsv/mermaid/issues/293)
+- Basic chart does not render on Chome, but does in Firefox [#290](https://github.com/knsv/mermaid/issues/290)
+- Live editor is broken [#285](https://github.com/knsv/mermaid/issues/285)
+- "No such file or directory" trying to run mermaid 0.5.7 on OS X [#284](https://github.com/knsv/mermaid/issues/284)
+- participant name as "Long Long Name" [#283](https://github.com/knsv/mermaid/issues/283)
+- Windows - cli - could not find phantomjs at the specified path [#236](https://github.com/knsv/mermaid/issues/236)
+
+**Merged pull requests:**
+
+- The option of gantt for the spaces for the section names. [#353](https://github.com/knsv/mermaid/pull/353) ([zeroyonichihachi](https://github.com/zeroyonichihachi))
+- Gitgraph: Make reset work with parent ref carets [#350](https://github.com/knsv/mermaid/pull/350) ([raghur](https://github.com/raghur))
+- Remove the text-shadows that make the text look blurry [#349](https://github.com/knsv/mermaid/pull/349) ([AsaAyers](https://github.com/AsaAyers))
+- add line interpolation to linkStyle in flowchart [#346](https://github.com/knsv/mermaid/pull/346) ([AlanHohn](https://github.com/AlanHohn))
+- Support git graph diagrams in mermaid [#344](https://github.com/knsv/mermaid/pull/344) ([raghur](https://github.com/raghur))
+- Build and test execution changes [#338](https://github.com/knsv/mermaid/pull/338) ([ssbarnea](https://github.com/ssbarnea))
+- Reformatting of css files [#331](https://github.com/knsv/mermaid/pull/331) ([Jmuccigr](https://github.com/Jmuccigr))
+- (WIP) Sequence Diagram Title Support [#320](https://github.com/knsv/mermaid/pull/320) ([bronsoja](https://github.com/bronsoja))
+- activations doc + few fixes [#318](https://github.com/knsv/mermaid/pull/318) ([ciekawy](https://github.com/ciekawy))
+- Dark theme for better contrast on darker backgrounds [#317](https://github.com/knsv/mermaid/pull/317) ([crodriguez1a](https://github.com/crodriguez1a))
+- Activations [#316](https://github.com/knsv/mermaid/pull/316) ([ciekawy](https://github.com/ciekawy))
+- Support leading comments for sequenceDiagrams [#312](https://github.com/knsv/mermaid/pull/312) ([ashsearle](https://github.com/ashsearle))
+- Show a little lenience for white-space around names [#309](https://github.com/knsv/mermaid/pull/309) ([ashsearle](https://github.com/ashsearle))
+- Update list of downstream projects [#307](https://github.com/knsv/mermaid/pull/307) ([maxArturo](https://github.com/maxArturo))
+- Issue 299: Sequence diagram Loops: changing boxMargin spoils the "loop" notation [#300](https://github.com/knsv/mermaid/pull/300) ([LarryKlugerDS](https://github.com/LarryKlugerDS))
+- Issue 297 - src/mermaid.js generates bad code [#298](https://github.com/knsv/mermaid/pull/298) ([LarryKlugerDS](https://github.com/LarryKlugerDS))
+- Updated instructions for running tests [#295](https://github.com/knsv/mermaid/pull/295) ([LarryKlugerDS](https://github.com/LarryKlugerDS))
+- Add Markdown Plus to Downstream projects [#288](https://github.com/knsv/mermaid/pull/288) ([tylerlong](https://github.com/tylerlong))
+- Quote phantomPath so that it doesn't fail on window [#286](https://github.com/knsv/mermaid/pull/286) ([raghur](https://github.com/raghur))
+
+## [0.5.8](https://github.com/knsv/mermaid/tree/0.5.8) (2016-01-27)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.7...0.5.8)
+
+## [0.5.7](https://github.com/knsv/mermaid/tree/0.5.7) (2016-01-25)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.6...0.5.7)
+
+**Closed issues:**
+
+- Mermaid + LightPaper = ❤️ [#280](https://github.com/knsv/mermaid/issues/280)
+- Bower Integration [#278](https://github.com/knsv/mermaid/issues/278)
+- Mermaid breaks when variables end in 'v' [#276](https://github.com/knsv/mermaid/issues/276)
+- sequence diagrams don't support participant aliasing [#263](https://github.com/knsv/mermaid/issues/263)
+- One diagram that fails to render stops further execution on the page [#259](https://github.com/knsv/mermaid/issues/259)
+- Where to find line layout algorithm? [#258](https://github.com/knsv/mermaid/issues/258)
+- Compatibility with node.js [#257](https://github.com/knsv/mermaid/issues/257)
+- Label resizing with dynamically loaded fonts [#255](https://github.com/knsv/mermaid/issues/255)
+- SVG arrowheads are broken in the CLI [#249](https://github.com/knsv/mermaid/issues/249)
+- Cannot read property 'replace' of undefined [#239](https://github.com/knsv/mermaid/issues/239)
+
+**Merged pull requests:**
+
+- gh-50 Allow styling of edge labels in css [#267](https://github.com/knsv/mermaid/pull/267) ([Anoia](https://github.com/Anoia))
+- Allow sequenceDiagram participant aliasing [#265](https://github.com/knsv/mermaid/pull/265) ([gibson042](https://github.com/gibson042))
+
+## [0.5.6](https://github.com/knsv/mermaid/tree/0.5.6) (2015-11-22)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.5...0.5.6)
+
+**Implemented enhancements:**
+
+- Add download SVG link to the live editor [#144](https://github.com/knsv/mermaid/issues/144)
+
+**Fixed bugs:**
+
+- Live Editor: Permalink address not being parsed [#202](https://github.com/knsv/mermaid/issues/202)
+
+**Closed issues:**
+
+- title doesn't work in sequenceDiagram [#248](https://github.com/knsv/mermaid/issues/248)
+- hypen-minus should be valid in sequence diagram alt/else/etc. descriptions [#247](https://github.com/knsv/mermaid/issues/247)
+- Broken in firefox? [#245](https://github.com/knsv/mermaid/issues/245)
+- When there is a Chinese symbol in the flowchart, it will crash。 [#238](https://github.com/knsv/mermaid/issues/238)
+- Non-alpha characters included in ALPHA token (flow graph jison) [#232](https://github.com/knsv/mermaid/issues/232)
+- subgraph not rendering with change to sample [#231](https://github.com/knsv/mermaid/issues/231)
+- sequence diagram requires a new line at the end? [#229](https://github.com/knsv/mermaid/issues/229)
+
+**Merged pull requests:**
+
+- Make sequenceDiagram terminal newline optional [#253](https://github.com/knsv/mermaid/pull/253) ([gibson042](https://github.com/gibson042))
+- Support sequenceDiagram "over" notes [#252](https://github.com/knsv/mermaid/pull/252) ([gibson042](https://github.com/gibson042))
+- Properly handle "rest of line" statements [#251](https://github.com/knsv/mermaid/pull/251) ([gibson042](https://github.com/gibson042))
+- CLI: Propagate exit code from lib (i.e., phantomjs) [#250](https://github.com/knsv/mermaid/pull/250) ([gibson042](https://github.com/gibson042))
+- flowRender.js - Fix FontAwesome icon insert [#244](https://github.com/knsv/mermaid/pull/244) ([ma-zal](https://github.com/ma-zal))
+- updated sequence diagram link in live editor [#242](https://github.com/knsv/mermaid/pull/242) ([r-a-v-a-s](https://github.com/r-a-v-a-s))
+- updated links in README.md [#240](https://github.com/knsv/mermaid/pull/240) ([r-a-v-a-s](https://github.com/r-a-v-a-s))
+- Ellipse syntax [#237](https://github.com/knsv/mermaid/pull/237) ([spect88](https://github.com/spect88))
+- Allow keywords as suffixes of node ids [#235](https://github.com/knsv/mermaid/pull/235) ([spect88](https://github.com/spect88))
+- Highlighted the editor in the nav [#234](https://github.com/knsv/mermaid/pull/234) ([knsv](https://github.com/knsv))
+- Live editor tweaks [#233](https://github.com/knsv/mermaid/pull/233) ([spect88](https://github.com/spect88))
+- Add a Gitter chat badge to README.md [#230](https://github.com/knsv/mermaid/pull/230) ([gitter-badger](https://github.com/gitter-badger))
+
+## [0.5.5](https://github.com/knsv/mermaid/tree/0.5.5) (2015-10-21)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.4...0.5.5)
+
+**Closed issues:**
+
+- sequence diagram, arrowhead instead of crosshead [#227](https://github.com/knsv/mermaid/issues/227)
+
+**Merged pull requests:**
+
+- Fix a typo: crosshead --> arrowhead [#228](https://github.com/knsv/mermaid/pull/228) ([tylerlong](https://github.com/tylerlong))
+
+## [0.5.4](https://github.com/knsv/mermaid/tree/0.5.4) (2015-10-19)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.3...0.5.4)
+
+**Implemented enhancements:**
+
+- Set log level from mermaid configuration [#220](https://github.com/knsv/mermaid/issues/220)
+- Links in sequence diagrams [#159](https://github.com/knsv/mermaid/issues/159)
+- Add syntax for double headed arrows [#123](https://github.com/knsv/mermaid/issues/123)
+
+**Fixed bugs:**
+
+- comment characters `%%` cause parse error [#141](https://github.com/knsv/mermaid/issues/141)
+
+**Closed issues:**
+
+- Marker-end arrow cannot be shown for URL with query parameter [#225](https://github.com/knsv/mermaid/issues/225)
+- Please update bower's D3 version [#221](https://github.com/knsv/mermaid/issues/221)
+- Width fixed to 400px [#204](https://github.com/knsv/mermaid/issues/204)
+- render to png from the cli does not display the marker-end arrow heads [#181](https://github.com/knsv/mermaid/issues/181)
+
+**Merged pull requests:**
+
+- Allow `end` as a substring of vertex id [#224](https://github.com/knsv/mermaid/pull/224) ([spect88](https://github.com/spect88))
+- Remove duplicate npm dependencies: d3 and he [#223](https://github.com/knsv/mermaid/pull/223) ([spect88](https://github.com/spect88))
+
+## [0.5.3](https://github.com/knsv/mermaid/tree/0.5.3) (2015-10-04)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.2...0.5.3)
+
+## [0.5.2](https://github.com/knsv/mermaid/tree/0.5.2) (2015-10-04)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.1...0.5.2)
+
+**Implemented enhancements:**
+
+- Support for hyperlink and tooltip [#34](https://github.com/knsv/mermaid/issues/34)
+
+**Closed issues:**
+
+- Installing “atom-mermaid@0.1.3” failed [#218](https://github.com/knsv/mermaid/issues/218)
+- node feature request [#211](https://github.com/knsv/mermaid/issues/211)
+- Please add prefix for styles [#208](https://github.com/knsv/mermaid/issues/208)
+- Bad handling of block arguments [#207](https://github.com/knsv/mermaid/issues/207)
+- please consider port to mac osx [#203](https://github.com/knsv/mermaid/issues/203)
+- allow phantomjs >=1.9.x [#201](https://github.com/knsv/mermaid/issues/201)
+- syntax for venn diagrams? [#200](https://github.com/knsv/mermaid/issues/200)
+- Broken CLI Graphs? (v0.5.1) [#196](https://github.com/knsv/mermaid/issues/196)
+- Static site does not render under HTTPS [#194](https://github.com/knsv/mermaid/issues/194)
+- Error on simple graph [#192](https://github.com/knsv/mermaid/issues/192)
+- Escape "~" [#191](https://github.com/knsv/mermaid/issues/191)
+- Trying to add link using 'click' to flowchart [#188](https://github.com/knsv/mermaid/issues/188)
+- cli: no lines and arrowheads rendered / only dotted lines [#187](https://github.com/knsv/mermaid/issues/187)
+- text of mermaid div displayed on page [#186](https://github.com/knsv/mermaid/issues/186)
+- using mermaid with laravel [#185](https://github.com/knsv/mermaid/issues/185)
+- Atom editor package [#183](https://github.com/knsv/mermaid/issues/183)
+- Auto linewrap for notes in sequence diagrams [#178](https://github.com/knsv/mermaid/issues/178)
+- Execute code after initialize [#176](https://github.com/knsv/mermaid/issues/176)
+- Autoscaling for all diagram types [#175](https://github.com/knsv/mermaid/issues/175)
+- Problem wit click event callback [#174](https://github.com/knsv/mermaid/issues/174)
+- How to escape characters? [#170](https://github.com/knsv/mermaid/issues/170)
+- it can not work [#167](https://github.com/knsv/mermaid/issues/167)
+- Broken subgraph using the CLI [#153](https://github.com/knsv/mermaid/issues/153)
+- IE Support issue [#142](https://github.com/knsv/mermaid/issues/142)
+- Flowchart truncated [#140](https://github.com/knsv/mermaid/issues/140)
+- Double Quote as text is not working [#219](https://github.com/knsv/mermaid/issues/219)
+- classDef / class not working with htmlLabels? [#210](https://github.com/knsv/mermaid/issues/210)
+- Links in graph missing [#209](https://github.com/knsv/mermaid/issues/209)
+- Last word in comment boxes getting cut off by word wrap library : ( [#195](https://github.com/knsv/mermaid/issues/195)
+- Escaping characters in sequence diagram [#193](https://github.com/knsv/mermaid/issues/193)
+- SVG foreignObject rendering [#180](https://github.com/knsv/mermaid/issues/180)
+- IE9 issue [#179](https://github.com/knsv/mermaid/issues/179)
+- inoperable in an AMD/requirejs environment: IPython Notebook [#127](https://github.com/knsv/mermaid/issues/127)
+- \[Parser] Hyphen in participant name bring TypeError [#74](https://github.com/knsv/mermaid/issues/74)
+
+**Merged pull requests:**
+
+- Update flowchart.md [#214](https://github.com/knsv/mermaid/pull/214) ([orschiro](https://github.com/orschiro))
+- Default style when using the CLI [#205](https://github.com/knsv/mermaid/pull/205) ([gillesdemey](https://github.com/gillesdemey))
+- Gantt chart - add minutes and seconds durations [#198](https://github.com/knsv/mermaid/pull/198) ([dbrans](https://github.com/dbrans))
+- Using QUnit for AMD testing [#190](https://github.com/knsv/mermaid/pull/190) ([bollwyvl](https://github.com/bollwyvl))
+- Update phantomscript.js [#182](https://github.com/knsv/mermaid/pull/182) ([phairow](https://github.com/phairow))
+
+## [0.5.1](https://github.com/knsv/mermaid/tree/0.5.1) (2015-06-21)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.5.0...0.5.1)
+
+**Implemented enhancements:**
+
+- To SVG Export [#146](https://github.com/knsv/mermaid/issues/146)
+- Possibility to set the width of the generated flowchart [#129](https://github.com/knsv/mermaid/issues/129)
+- Special characters break parsing [#54](https://github.com/knsv/mermaid/issues/54)
+- Responsive graph layout for mobile viewers [#51](https://github.com/knsv/mermaid/issues/51)
+- Styling connector lines [#31](https://github.com/knsv/mermaid/issues/31)
+
+**Fixed bugs:**
+
+- flowchart - styling of edges via css overrides specific styles set in the graph definition [#128](https://github.com/knsv/mermaid/issues/128)
+
+**Closed issues:**
+
+- Live editor is broken [#173](https://github.com/knsv/mermaid/issues/173)
+- 0.5.0 no longer respects custom date definitions in Gantt diagrams [#171](https://github.com/knsv/mermaid/issues/171)
+- Drop label character restrictions [#162](https://github.com/knsv/mermaid/issues/162)
+- can't nest subgraphs in flowchart [#161](https://github.com/knsv/mermaid/issues/161)
+- Unable to generate gantt diagram with mermaid CLI [#158](https://github.com/knsv/mermaid/issues/158)
+- Inline css by "mermaid" [#157](https://github.com/knsv/mermaid/issues/157)
+- Finite State Machine Diagram [#152](https://github.com/knsv/mermaid/issues/152)
+- How to center align gantt diagram [#150](https://github.com/knsv/mermaid/issues/150)
+- Security concern regarding class definition [#148](https://github.com/knsv/mermaid/issues/148)
+- File Extension [#147](https://github.com/knsv/mermaid/issues/147)
+- `setTimeout` with clusters problematic with programmatic edits and no callback [#133](https://github.com/knsv/mermaid/issues/133)
+- module.exports.cloneCssStyles() in combination with Angularjs breaks display in Chrome and IE [#126](https://github.com/knsv/mermaid/issues/126)
+- Gantt - suitable xAxis for longer project [#125](https://github.com/knsv/mermaid/issues/125)
+- How to get started with this project ? [#64](https://github.com/knsv/mermaid/issues/64)
+
+**Merged pull requests:**
+
+- Remove moot `version` property from bower.json [#172](https://github.com/knsv/mermaid/pull/172) ([kkirsche](https://github.com/kkirsche))
+
+## [0.5.0](https://github.com/knsv/mermaid/tree/0.5.0) (2015-06-07)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.4.0...0.5.0)
+
+**Implemented enhancements:**
+
+- Add a css file, mermaid.css, with default styling [#122](https://github.com/knsv/mermaid/issues/122)
+- software architecture diagram [#36](https://github.com/knsv/mermaid/issues/36)
+- Support for bar charts and pie diagrams [#22](https://github.com/knsv/mermaid/issues/22)
+
+**Closed issues:**
+
+- uglifyjs wanrings which means we can improve the code [#156](https://github.com/knsv/mermaid/issues/156)
+- New(er) features unavailable in downloadable js files? [#151](https://github.com/knsv/mermaid/issues/151)
+- Add gh-gapes link to description [#143](https://github.com/knsv/mermaid/issues/143)
+- Some examples not displayed on Firefox 36.0.1 [#138](https://github.com/knsv/mermaid/issues/138)
+- tags ending in a "v" don't render [#132](https://github.com/knsv/mermaid/issues/132)
+- Links in flowchart [#131](https://github.com/knsv/mermaid/issues/131)
+- Using the library for iOS development [#130](https://github.com/knsv/mermaid/issues/130)
+- Add capability for gantt diagrams [#118](https://github.com/knsv/mermaid/issues/118)
+- lower case v causes error in the parser [#108](https://github.com/knsv/mermaid/issues/108)
+- Label's css conflict with boostrap's .label [#67](https://github.com/knsv/mermaid/issues/67)
+- TypeError: Cannot read property 'layout' of undefined [#37](https://github.com/knsv/mermaid/issues/37)
+
+**Merged pull requests:**
+
+- Dev 0.5.0 [#168](https://github.com/knsv/mermaid/pull/168) ([knsv](https://github.com/knsv))
+- Fix spacing [#164](https://github.com/knsv/mermaid/pull/164) ([rhcarvalho](https://github.com/rhcarvalho))
+- Fixing typo: "Think" -> "Thick" [#160](https://github.com/knsv/mermaid/pull/160) ([it0a](https://github.com/it0a))
+- IE, local html, cssRules access is denied [#155](https://github.com/knsv/mermaid/pull/155) ([tylerlong](https://github.com/tylerlong))
+- Add automatically generated change log file. [#139](https://github.com/knsv/mermaid/pull/139) ([skywinder](https://github.com/skywinder))
+- Adding init argument to the global API [#137](https://github.com/knsv/mermaid/pull/137) ([bollwyvl](https://github.com/bollwyvl))
+- Add description of manual calling of init [#136](https://github.com/knsv/mermaid/pull/136) ([bollwyvl](https://github.com/bollwyvl))
+- Allow other forms of node selection for init() [#135](https://github.com/knsv/mermaid/pull/135) ([bollwyvl](https://github.com/bollwyvl))
+- Use a library-level variable for assigning ids [#134](https://github.com/knsv/mermaid/pull/134) ([bollwyvl](https://github.com/bollwyvl))
+
+## [0.4.0](https://github.com/knsv/mermaid/tree/0.4.0) (2015-03-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.5...0.4.0)
+
+**Implemented enhancements:**
+
+- Assymetric shapes not documented [#82](https://github.com/knsv/mermaid/issues/82)
+- Improve arrows [#3](https://github.com/knsv/mermaid/issues/3)
+
+**Fixed bugs:**
+
+- NoModificationAllowedError [#23](https://github.com/knsv/mermaid/issues/23)
+
+**Closed issues:**
+
+- subgraph background is black in rendered flowchart PNG via CLI [#121](https://github.com/knsv/mermaid/issues/121)
+- Integrate editor at https://github.com/naseer/mermaid-webapp [#110](https://github.com/knsv/mermaid/issues/110)
+- Internet Explorer Support [#99](https://github.com/knsv/mermaid/issues/99)
+
+## [0.3.5](https://github.com/knsv/mermaid/tree/0.3.5) (2015-02-15)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.4...0.3.5)
+
+## [0.3.4](https://github.com/knsv/mermaid/tree/0.3.4) (2015-02-15)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.3...0.3.4)
+
+**Implemented enhancements:**
+
+- Apply styling from css when using the CLI utility [#85](https://github.com/knsv/mermaid/issues/85)
+- Generated SVG works poorly outside web browsers [#58](https://github.com/knsv/mermaid/issues/58)
+- Generating SVG text blob for use in Node [#2](https://github.com/knsv/mermaid/issues/2)
+
+**Closed issues:**
+
+- Subgraph syntax bug? [#120](https://github.com/knsv/mermaid/issues/120)
+- Live editor [#115](https://github.com/knsv/mermaid/issues/115)
+- Error in "Basic Syntax" wiki page [#113](https://github.com/knsv/mermaid/issues/113)
+- semicolons, anyone? [#111](https://github.com/knsv/mermaid/issues/111)
+- undefined `sequenceConfig` fails [#109](https://github.com/knsv/mermaid/issues/109)
+- Sequence Diagrams: Show Actors below as well [#106](https://github.com/knsv/mermaid/issues/106)
+- Allow overriding sequence diagram configuration (SVG properties) [#103](https://github.com/knsv/mermaid/issues/103)
+- Error when rendering A-- This is the text -- B [#102](https://github.com/knsv/mermaid/issues/102)
+- Clipping in documentation [#97](https://github.com/knsv/mermaid/issues/97)
+- isolate class styling to the svg container [#92](https://github.com/knsv/mermaid/issues/92)
+- Make the new graph declaration more visual [#40](https://github.com/knsv/mermaid/issues/40)
+
+**Merged pull requests:**
+
+- Add live editor [#119](https://github.com/knsv/mermaid/pull/119) ([naseer](https://github.com/naseer))
+- Adds CSS option to the CLI [#116](https://github.com/knsv/mermaid/pull/116) ([fardog](https://github.com/fardog))
+- Update flowchart.md in response Issue #113 [#114](https://github.com/knsv/mermaid/pull/114) ([vijay40](https://github.com/vijay40))
+- Ignore all files except the license and dist/ folder when installing with Bower. [#112](https://github.com/knsv/mermaid/pull/112) ([jasonbellamy](https://github.com/jasonbellamy))
+
+## [0.3.3](https://github.com/knsv/mermaid/tree/0.3.3) (2015-01-25)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.2...0.3.3)
+
+**Implemented enhancements:**
+
+- Support for dotted links [#26](https://github.com/knsv/mermaid/issues/26)
+
+**Closed issues:**
+
+- Missing arrows in sequence diagram [#98](https://github.com/knsv/mermaid/issues/98)
+- Error with >9 linkStyles [#95](https://github.com/knsv/mermaid/issues/95)
+
+**Merged pull requests:**
+
+- Require d3 directly to better support Node usage [#107](https://github.com/knsv/mermaid/pull/107) ([markdalgleish](https://github.com/markdalgleish))
+- update doc with -c option [#105](https://github.com/knsv/mermaid/pull/105) ([jjmr](https://github.com/jjmr))
+- Add new parameter to the console client to override the svg configuration in sequence diagrams [#104](https://github.com/knsv/mermaid/pull/104) ([jjmr](https://github.com/jjmr))
+- Text based labels, new shape [#101](https://github.com/knsv/mermaid/pull/101) ([bjowes](https://github.com/bjowes))
+- fix html tags in example usage [#100](https://github.com/knsv/mermaid/pull/100) ([deiwin](https://github.com/deiwin))
+
+## [0.3.2](https://github.com/knsv/mermaid/tree/0.3.2) (2015-01-11)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.1...0.3.2)
+
+**Implemented enhancements:**
+
+- Make link text look like it is on the line [#53](https://github.com/knsv/mermaid/issues/53)
+
+**Closed issues:**
+
+- disable auto render [#91](https://github.com/knsv/mermaid/issues/91)
+- Tidy breaks mermaid (linebreaks in \<div>) [#87](https://github.com/knsv/mermaid/issues/87)
+- Bug: \<br> being rendered as text in node [#73](https://github.com/knsv/mermaid/issues/73)
+- Graph edges appear to render outside of the canvas [#70](https://github.com/knsv/mermaid/issues/70)
+
+**Merged pull requests:**
+
+- Merge pull request #1 from knsv/master [#96](https://github.com/knsv/mermaid/pull/96) ([gkchic](https://github.com/gkchic))
+- Removed duplicated section in flowchart docs [#94](https://github.com/knsv/mermaid/pull/94) ([kaime](https://github.com/kaime))
+- Grammar changes to sequence page [#93](https://github.com/knsv/mermaid/pull/93) ([gkchic](https://github.com/gkchic))
+- Github buttons [#89](https://github.com/knsv/mermaid/pull/89) ([gkchic](https://github.com/gkchic))
+- Template change [#88](https://github.com/knsv/mermaid/pull/88) ([gkchic](https://github.com/gkchic))
+
+## [0.3.1](https://github.com/knsv/mermaid/tree/0.3.1) (2015-01-05)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.3.0...0.3.1)
+
+**Implemented enhancements:**
+
+- Support for sequence diagrams [#16](https://github.com/knsv/mermaid/issues/16)
+- Client utility for mermaid [#6](https://github.com/knsv/mermaid/issues/6)
+
+**Closed issues:**
+
+- Non ASCII chars in labels [#84](https://github.com/knsv/mermaid/issues/84)
+- 'undefined' titles of Quicklinks on the usage page [#80](https://github.com/knsv/mermaid/issues/80)
+- \[cli] Enhancement proposal: not fail --version / --help if phantomjs isn't installed [#71](https://github.com/knsv/mermaid/issues/71)
+
+**Merged pull requests:**
+
+- Flowchart doc: Text in the circle now in a circle [#81](https://github.com/knsv/mermaid/pull/81) ([Grahack](https://github.com/Grahack))
+- Fix for issue #73 [#79](https://github.com/knsv/mermaid/pull/79) ([it0a](https://github.com/it0a))
+- Ink template [#78](https://github.com/knsv/mermaid/pull/78) ([gkchic](https://github.com/gkchic))
+- Show help and version even if phantom isn't present. Fixes #71 [#75](https://github.com/knsv/mermaid/pull/75) ([fardog](https://github.com/fardog))
+- Add apostrophe & 'and' [#72](https://github.com/knsv/mermaid/pull/72) ([sudodoki](https://github.com/sudodoki))
+
+## [0.3.0](https://github.com/knsv/mermaid/tree/0.3.0) (2014-12-22)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.16...0.3.0)
+
+**Implemented enhancements:**
+
+- How do I do comments? [#47](https://github.com/knsv/mermaid/issues/47)
+- Improve readability with new line as terminator and whitespace [#38](https://github.com/knsv/mermaid/issues/38)
+
+**Fixed bugs:**
+
+- This characters failed the lexical parsing [#46](https://github.com/knsv/mermaid/issues/46)
+
+**Closed issues:**
+
+- Trailing whitespace at the end of lines is not ignored [#55](https://github.com/knsv/mermaid/issues/55)
+- Use classes instead of inline style for easy styling [#24](https://github.com/knsv/mermaid/issues/24)
+
+**Merged pull requests:**
+
+- Adds Command Line Interface for generating PNGs from mermaid description files [#69](https://github.com/knsv/mermaid/pull/69) ([fardog](https://github.com/fardog))
+- Allow special symbols for direction along with acronyms [#66](https://github.com/knsv/mermaid/pull/66) ([vijay40](https://github.com/vijay40))
+
+## [0.2.16](https://github.com/knsv/mermaid/tree/0.2.16) (2014-12-15)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.15...0.2.16)
+
+**Fixed bugs:**
+
+- Lines routed outside visible area [#19](https://github.com/knsv/mermaid/issues/19)
+
+**Closed issues:**
+
+- Mermaid not rendering properly on Wordpress pages [#59](https://github.com/knsv/mermaid/issues/59)
+- Improve example page with live demo [#52](https://github.com/knsv/mermaid/issues/52)
+- Does not render upon AngularJS Updates [#45](https://github.com/knsv/mermaid/issues/45)
+- Download link in README.MD doesn't work. [#42](https://github.com/knsv/mermaid/issues/42)
+- linkStyle usage is not obvious [#41](https://github.com/knsv/mermaid/issues/41)
+- Move \*.spec.js in src/ to test/ [#35](https://github.com/knsv/mermaid/issues/35)
+
+**Merged pull requests:**
+
+- New grammar will allow statements ending without semicolon as disccused in Issue #38 [#63](https://github.com/knsv/mermaid/pull/63) ([vijay40](https://github.com/vijay40))
+- Class based styling [#62](https://github.com/knsv/mermaid/pull/62) ([bjowes](https://github.com/bjowes))
+- Fix typos [#60](https://github.com/knsv/mermaid/pull/60) ([sublimino](https://github.com/sublimino))
+- Included .DS_Store in gitignore [#57](https://github.com/knsv/mermaid/pull/57) ([alvynmcq](https://github.com/alvynmcq))
+- Improves readability discussed in issue #38 [#56](https://github.com/knsv/mermaid/pull/56) ([vijay40](https://github.com/vijay40))
+- Added a linting task for gulp [#43](https://github.com/knsv/mermaid/pull/43) ([serv](https://github.com/serv))
+
+## [0.2.15](https://github.com/knsv/mermaid/tree/0.2.15) (2014-12-05)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.14...0.2.15)
+
+**Fixed bugs:**
+
+- Error with some characters [#25](https://github.com/knsv/mermaid/issues/25)
+- Cap-cased words break parser [#8](https://github.com/knsv/mermaid/issues/8)
+
+**Closed issues:**
+
+- Question marks don't render properly with /dist/mermaid.full.min.js [#30](https://github.com/knsv/mermaid/issues/30)
+- Provide parse function in browser widthout `require`? [#21](https://github.com/knsv/mermaid/issues/21)
+- Better label text support [#18](https://github.com/knsv/mermaid/issues/18)
+
+**Merged pull requests:**
+
+- Include bower_components/ to .gitignore [#33](https://github.com/knsv/mermaid/pull/33) ([serv](https://github.com/serv))
+- Fixed reference to Git repo. [#32](https://github.com/knsv/mermaid/pull/32) ([guyellis](https://github.com/guyellis))
+
+## [0.2.14](https://github.com/knsv/mermaid/tree/0.2.14) (2014-12-03)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.13...0.2.14)
+
+## [0.2.13](https://github.com/knsv/mermaid/tree/0.2.13) (2014-12-03)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.10...0.2.13)
+
+**Implemented enhancements:**
+
+- Publish to NPM [#7](https://github.com/knsv/mermaid/issues/7)
+
+**Closed issues:**
+
+- modified init to be applied more than once [#29](https://github.com/knsv/mermaid/issues/29)
+- Wanted to know build process for the project. [#28](https://github.com/knsv/mermaid/issues/28)
+- can not support Chinese description [#20](https://github.com/knsv/mermaid/issues/20)
+- Support unicode chars in labels [#9](https://github.com/knsv/mermaid/issues/9)
+
+## [0.2.10](https://github.com/knsv/mermaid/tree/0.2.10) (2014-12-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.9...0.2.10)
+
+## [0.2.9](https://github.com/knsv/mermaid/tree/0.2.9) (2014-12-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.8...0.2.9)
+
+**Closed issues:**
+
+- Add link to jsbin playground to README [#11](https://github.com/knsv/mermaid/issues/11)
+- What are the requirements ? [#10](https://github.com/knsv/mermaid/issues/10)
+
+**Merged pull requests:**
+
+- Allow unicode chars in labels [#13](https://github.com/knsv/mermaid/pull/13) ([codebeige](https://github.com/codebeige))
+
+## [0.2.8](https://github.com/knsv/mermaid/tree/0.2.8) (2014-12-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.7...0.2.8)
+
+## [0.2.7](https://github.com/knsv/mermaid/tree/0.2.7) (2014-12-01)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.6...0.2.7)
+
+**Closed issues:**
+
+- Provide parser as separate module [#4](https://github.com/knsv/mermaid/issues/4)
+
+## [0.2.6](https://github.com/knsv/mermaid/tree/0.2.6) (2014-11-27)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.5...0.2.6)
+
+## [0.2.5](https://github.com/knsv/mermaid/tree/0.2.5) (2014-11-27)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.4...0.2.5)
+
+**Merged pull requests:**
+
+- Added new shapes! [#1](https://github.com/knsv/mermaid/pull/1) ([bjowes](https://github.com/bjowes))
+
+## [0.2.4](https://github.com/knsv/mermaid/tree/0.2.4) (2014-11-25)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.3...0.2.4)
+
+## [0.2.3](https://github.com/knsv/mermaid/tree/0.2.3) (2014-11-24)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.2...0.2.3)
+
+## [0.2.2](https://github.com/knsv/mermaid/tree/0.2.2) (2014-11-22)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.1...0.2.2)
+
+## [0.2.1](https://github.com/knsv/mermaid/tree/0.2.1) (2014-11-22)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.2.0...0.2.1)
+
+## [0.2.0](https://github.com/knsv/mermaid/tree/0.2.0) (2014-11-22)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.1.1...0.2.0)
+
+## [0.1.1](https://github.com/knsv/mermaid/tree/0.1.1) (2014-11-17)
+
+[Full Changelog](https://github.com/knsv/mermaid/compare/0.1.0...0.1.1)
+
+## [0.1.0](https://github.com/knsv/mermaid/tree/0.1.0) (2014-11-16)
diff --git a/docs/community/development.md b/docs/community/development.md
index 7ccd31f6a..3e0a7c8a6 100644
--- a/docs/community/development.md
+++ b/docs/community/development.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Development and Contribution 🙌
 
diff --git a/docs/community/n00b-overview.md b/docs/community/n00b-overview.md
index e601432b2..06bf5fc8a 100644
--- a/docs/community/n00b-overview.md
+++ b/docs/community/n00b-overview.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Overview for Beginners
 
diff --git a/docs/community/newDiagram.md b/docs/community/newDiagram.md
index 6d3f811eb..dc05aa193 100644
--- a/docs/community/newDiagram.md
+++ b/docs/community/newDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Adding a New Diagram/Chart 📊
 
diff --git a/docs/community/security.md b/docs/community/security.md
index 62334e026..ee9033ca2 100644
--- a/docs/community/security.md
+++ b/docs/community/security.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Security
 
diff --git a/docs/config/8.6.0_docs.md b/docs/config/8.6.0_docs.md
index dddf5979f..782affe78 100644
--- a/docs/config/8.6.0_docs.md
+++ b/docs/config/8.6.0_docs.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Version 8.6.0 Changes
 
diff --git a/docs/config/Tutorials.md b/docs/config/Tutorials.md
index 3894c99f3..f76124251 100644
--- a/docs/config/Tutorials.md
+++ b/docs/config/Tutorials.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Tutorials
 
diff --git a/docs/config/accessibility.md b/docs/config/accessibility.md
index 68e825425..d699be01e 100644
--- a/docs/config/accessibility.md
+++ b/docs/config/accessibility.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Accessibility Options
 
diff --git a/docs/config/configuration.md b/docs/config/configuration.md
index 1c2a5566a..e764e200a 100644
--- a/docs/config/configuration.md
+++ b/docs/config/configuration.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Configuration
 
diff --git a/docs/config/directives.md b/docs/config/directives.md
index 85d678139..8185af294 100644
--- a/docs/config/directives.md
+++ b/docs/config/directives.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Directives
 
diff --git a/docs/config/mermaidCLI.md b/docs/config/mermaidCLI.md
index a2cc8a21a..0d32c5472 100644
--- a/docs/config/mermaidCLI.md
+++ b/docs/config/mermaidCLI.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # mermaid CLI
 
diff --git a/docs/config/n00b-advanced.md b/docs/config/n00b-advanced.md
index 2ca0d684f..b8970142a 100644
--- a/docs/config/n00b-advanced.md
+++ b/docs/config/n00b-advanced.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Advanced n00b mermaid (Coming soon..)
 
diff --git a/docs/config/setup/README.md b/docs/config/setup/README.md
index cc2038c20..28a7c2d97 100644
--- a/docs/config/setup/README.md
+++ b/docs/config/setup/README.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # mermaid
 
diff --git a/docs/config/setup/modules/config.md b/docs/config/setup/modules/config.md
index a24002c13..5171d8237 100644
--- a/docs/config/setup/modules/config.md
+++ b/docs/config/setup/modules/config.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Module: config
 
@@ -10,7 +10,7 @@
 
 #### Defined in
 
-[config.ts:7](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L7)
+[config.ts:7](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L7)
 
 ## Functions
 
@@ -32,7 +32,7 @@ Pushes in a directive to the configuration
 
 #### Defined in
 
-[config.ts:191](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L191)
+[config.ts:191](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L191)
 
 ---
 
@@ -56,7 +56,7 @@ Pushes in a directive to the configuration
 
 #### Defined in
 
-[config.ts:136](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L136)
+[config.ts:136](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L136)
 
 ---
 
@@ -80,7 +80,7 @@ Pushes in a directive to the configuration
 
 #### Defined in
 
-[config.ts:96](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L96)
+[config.ts:96](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L96)
 
 ---
 
@@ -114,7 +114,7 @@ Pushes in a directive to the configuration
 
 #### Defined in
 
-[config.ts:222](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L222)
+[config.ts:222](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L222)
 
 ---
 
@@ -143,7 +143,7 @@ options in-place
 
 #### Defined in
 
-[config.ts:151](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L151)
+[config.ts:151](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L151)
 
 ---
 
@@ -163,7 +163,7 @@ options in-place
 
 #### Defined in
 
-[config.ts:75](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L75)
+[config.ts:75](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L75)
 
 ---
 
@@ -195,7 +195,7 @@ corresponding siteConfig value.
 
 #### Defined in
 
-[config.ts:113](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L113)
+[config.ts:113](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L113)
 
 ---
 
@@ -228,7 +228,7 @@ function _Default value: At default, will mirror Global Config_
 
 #### Defined in
 
-[config.ts:61](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L61)
+[config.ts:61](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L61)
 
 ---
 
@@ -249,7 +249,7 @@ function _Default value: At default, will mirror Global Config_
 
 #### Defined in
 
-[config.ts:14](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L14)
+[config.ts:14](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L14)
 
 ---
 
@@ -269,4 +269,4 @@ function _Default value: At default, will mirror Global Config_
 
 #### Defined in
 
-[config.ts:79](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/config.ts#L79)
+[config.ts:79](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/config.ts#L79)
diff --git a/docs/config/setup/modules/defaultConfig.md b/docs/config/setup/modules/defaultConfig.md
index 24cd325fb..adbc05f8a 100644
--- a/docs/config/setup/modules/defaultConfig.md
+++ b/docs/config/setup/modules/defaultConfig.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Module: defaultConfig
 
@@ -10,7 +10,7 @@
 
 #### Defined in
 
-[defaultConfig.ts:1855](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/defaultConfig.ts#L1855)
+[defaultConfig.ts:1855](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/defaultConfig.ts#L1855)
 
 ---
 
@@ -52,4 +52,4 @@ Configuration
 
 #### Defined in
 
-[defaultConfig.ts:31](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/defaultConfig.ts#L31)
+[defaultConfig.ts:31](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/defaultConfig.ts#L31)
diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index cbb5d3351..c729e8af3 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Module: mermaidAPI
 
@@ -16,7 +16,7 @@ Renames and re-exports [mermaidAPI](mermaidAPI.md#mermaidapi)
 
 #### Defined in
 
-[mermaidAPI.ts:483](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/mermaidAPI.ts#L483)
+[mermaidAPI.ts:483](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/mermaidAPI.ts#L483)
 
 ## Functions
 
@@ -36,7 +36,7 @@ Renames and re-exports [mermaidAPI](mermaidAPI.md#mermaidapi)
 
 #### Defined in
 
-[mermaidAPI.ts:73](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/mermaidAPI.ts#L73)
+[mermaidAPI.ts:73](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/mermaidAPI.ts#L73)
 
 ---
 
@@ -56,4 +56,4 @@ Renames and re-exports [mermaidAPI](mermaidAPI.md#mermaidapi)
 
 #### Defined in
 
-[mermaidAPI.ts:47](https://github.com/emersonbottero/mermaid/blob/57b883c7/packages/mermaid/src/mermaidAPI.ts#L47)
+[mermaidAPI.ts:47](https://github.com/emersonbottero/mermaid/blob/0da56a12/packages/mermaid/src/mermaidAPI.ts#L47)
diff --git a/docs/config/theming.md b/docs/config/theming.md
index 32a624417..107bd4ddc 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Theme Configuration
 
diff --git a/docs/config/usage.md b/docs/config/usage.md
index 35d1ba68f..2a3ee0a8d 100644
--- a/docs/config/usage.md
+++ b/docs/config/usage.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Usage
 
diff --git a/docs/edit.md b/docs/edit.md
deleted file mode 100644
index 7d3dc338f..000000000
--- a/docs/edit.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
-
----
-
-layout: home
-
-## title: Live Mermaid
-
-<iframe id="editor" src="https://mermaid.live" style="position: fixed;left: 0px;bottom: 0px;right: 0px;top: 80px;width: 100%;height: calc(100% - 80px);"></iframe>
diff --git a/docs/index.md b/docs/index.md
index 282f12f87..0ff0584c1 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 ---
 
@@ -12,7 +12,7 @@ name: Mermaid
 text: Diagramming and charting tool
 tagline: JavaScript based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically.
 image:
-src: /header.png
+src: /mermaid-logo.svg
 alt: Mermaid
 actions:
 \- theme: brand
@@ -110,6 +110,7 @@ const members = [
   .image-container .image-src {
     margin: 1rem auto;
     max-width: 100%;
+    width: 100%;
   }
 
   .dark .image-src{
diff --git a/docs/intro/index.md b/docs/intro/index.md
index f38d1ab75..9bf4e4b6c 100644
--- a/docs/intro/index.md
+++ b/docs/intro/index.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # About Mermaid
 
diff --git a/docs/intro/n00b-gettingStarted.md b/docs/intro/n00b-gettingStarted.md
index 0b85ff162..48c3312ed 100644
--- a/docs/intro/n00b-gettingStarted.md
+++ b/docs/intro/n00b-gettingStarted.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # A Mermaid User-Guide for Beginners
 
diff --git a/docs/intro/n00b-syntaxReference.md b/docs/intro/n00b-syntaxReference.md
index 1169454e2..ad6d06cba 100644
--- a/docs/intro/n00b-syntaxReference.md
+++ b/docs/intro/n00b-syntaxReference.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Diagram Syntax
 
diff --git a/docs/misc/faq.md b/docs/misc/faq.md
index 3d3bcb7c3..ac5eeeb80 100644
--- a/docs/misc/faq.md
+++ b/docs/misc/faq.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Frequently Asked Questions
 
diff --git a/docs/misc/integrations.md b/docs/misc/integrations.md
index d0b3c5bb1..deac1e3b1 100644
--- a/docs/misc/integrations.md
+++ b/docs/misc/integrations.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Integrations
 
diff --git a/docs/public/android-icon-144x144.png b/docs/public/android-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/docs/public/android-icon-144x144.png differ
diff --git a/docs/public/android-icon-192x192.png b/docs/public/android-icon-192x192.png
new file mode 100644
index 000000000..5f6c40128
Binary files /dev/null and b/docs/public/android-icon-192x192.png differ
diff --git a/docs/public/android-icon-36x36.png b/docs/public/android-icon-36x36.png
new file mode 100644
index 000000000..40b1140fa
Binary files /dev/null and b/docs/public/android-icon-36x36.png differ
diff --git a/docs/public/android-icon-48x48.png b/docs/public/android-icon-48x48.png
new file mode 100644
index 000000000..c81790b84
Binary files /dev/null and b/docs/public/android-icon-48x48.png differ
diff --git a/docs/public/android-icon-72x72.png b/docs/public/android-icon-72x72.png
new file mode 100644
index 000000000..1866eb50e
Binary files /dev/null and b/docs/public/android-icon-72x72.png differ
diff --git a/docs/public/android-icon-96x96.png b/docs/public/android-icon-96x96.png
new file mode 100644
index 000000000..c2a1e3dc8
Binary files /dev/null and b/docs/public/android-icon-96x96.png differ
diff --git a/docs/public/apple-icon-114x114.png b/docs/public/apple-icon-114x114.png
new file mode 100644
index 000000000..ba11f97b1
Binary files /dev/null and b/docs/public/apple-icon-114x114.png differ
diff --git a/docs/public/apple-icon-120x120.png b/docs/public/apple-icon-120x120.png
new file mode 100644
index 000000000..05f58d801
Binary files /dev/null and b/docs/public/apple-icon-120x120.png differ
diff --git a/docs/public/apple-icon-144x144.png b/docs/public/apple-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/docs/public/apple-icon-144x144.png differ
diff --git a/docs/public/apple-icon-152x152.png b/docs/public/apple-icon-152x152.png
new file mode 100644
index 000000000..f5a82583c
Binary files /dev/null and b/docs/public/apple-icon-152x152.png differ
diff --git a/docs/public/apple-icon-180x180.png b/docs/public/apple-icon-180x180.png
new file mode 100644
index 000000000..752c4dcf6
Binary files /dev/null and b/docs/public/apple-icon-180x180.png differ
diff --git a/docs/public/apple-icon-57x57.png b/docs/public/apple-icon-57x57.png
new file mode 100644
index 000000000..653687ee2
Binary files /dev/null and b/docs/public/apple-icon-57x57.png differ
diff --git a/docs/public/apple-icon-60x60.png b/docs/public/apple-icon-60x60.png
new file mode 100644
index 000000000..e27a4529b
Binary files /dev/null and b/docs/public/apple-icon-60x60.png differ
diff --git a/docs/public/apple-icon-72x72.png b/docs/public/apple-icon-72x72.png
new file mode 100644
index 000000000..4c05a3c1b
Binary files /dev/null and b/docs/public/apple-icon-72x72.png differ
diff --git a/docs/public/apple-icon-76x76.png b/docs/public/apple-icon-76x76.png
new file mode 100644
index 000000000..4dae6668d
Binary files /dev/null and b/docs/public/apple-icon-76x76.png differ
diff --git a/docs/public/apple-icon-precomposed.png b/docs/public/apple-icon-precomposed.png
new file mode 100644
index 000000000..620c2b691
Binary files /dev/null and b/docs/public/apple-icon-precomposed.png differ
diff --git a/docs/public/apple-icon.png b/docs/public/apple-icon.png
new file mode 100644
index 000000000..620c2b691
Binary files /dev/null and b/docs/public/apple-icon.png differ
diff --git a/docs/public/browserconfig.xml b/docs/public/browserconfig.xml
new file mode 100644
index 000000000..c55414822
--- /dev/null
+++ b/docs/public/browserconfig.xml
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig><msapplication><tile><square70x70logo src="/ms-icon-70x70.png"/><square150x150logo src="/ms-icon-150x150.png"/><square310x310logo src="/ms-icon-310x310.png"/><TileColor>#ffffff</TileColor></tile></msapplication></browserconfig>
\ No newline at end of file
diff --git a/docs/public/favicon-16x16.png b/docs/public/favicon-16x16.png
new file mode 100644
index 000000000..238b81faf
Binary files /dev/null and b/docs/public/favicon-16x16.png differ
diff --git a/docs/public/favicon-32x32.png b/docs/public/favicon-32x32.png
new file mode 100644
index 000000000..7df5e64fc
Binary files /dev/null and b/docs/public/favicon-32x32.png differ
diff --git a/docs/public/favicon-96x96.png b/docs/public/favicon-96x96.png
new file mode 100644
index 000000000..c2a1e3dc8
Binary files /dev/null and b/docs/public/favicon-96x96.png differ
diff --git a/docs/public/favicon.ico b/docs/public/favicon.ico
new file mode 100644
index 000000000..d41818c5b
Binary files /dev/null and b/docs/public/favicon.ico differ
diff --git a/docs/public/manifest.json b/docs/public/manifest.json
new file mode 100644
index 000000000..3b557aab8
--- /dev/null
+++ b/docs/public/manifest.json
@@ -0,0 +1,41 @@
+{
+  "name": "App",
+  "icons": [
+    {
+      "src": "/android-icon-36x36.png",
+      "sizes": "36x36",
+      "type": "image/png",
+      "density": "0.75"
+    },
+    {
+      "src": "/android-icon-48x48.png",
+      "sizes": "48x48",
+      "type": "image/png",
+      "density": "1.0"
+    },
+    {
+      "src": "/android-icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "density": "1.5"
+    },
+    {
+      "src": "/android-icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "density": "2.0"
+    },
+    {
+      "src": "/android-icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "density": "3.0"
+    },
+    {
+      "src": "/android-icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "density": "4.0"
+    }
+  ]
+}
diff --git a/docs/public/mermaid-logo.svg b/docs/public/mermaid-logo.svg
new file mode 100644
index 000000000..5ac259968
--- /dev/null
+++ b/docs/public/mermaid-logo.svg
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 491 491" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <!-- <path d="M490.16,84.61C490.16,37.912 452.248,0 405.55,0L84.61,0C37.912,0 0,37.912 0,84.61L0,405.55C0,452.248 37.912,490.16 84.61,490.16L405.55,490.16C452.248,490.16 490.16,452.248 490.16,405.55L490.16,84.61Z" style="fill:rgb(255,54,112);"/> -->
+    <path d="M407.48,111.18C335.587,108.103 269.573,152.338 245.08,220C220.587,152.338 154.573,108.103 82.68,111.18C80.285,168.229 107.577,222.632 154.74,254.82C178.908,271.419 193.35,298.951 193.27,328.27L193.27,379.13L296.9,379.13L296.9,328.27C296.816,298.953 311.255,271.42 335.42,254.82C382.596,222.644 409.892,168.233 407.48,111.18Z" style="fill:white;fill-rule:nonzero;"/>
+</svg>
diff --git a/docs/public/ms-icon-144x144.png b/docs/public/ms-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/docs/public/ms-icon-144x144.png differ
diff --git a/docs/public/ms-icon-150x150.png b/docs/public/ms-icon-150x150.png
new file mode 100644
index 000000000..1785c0f1a
Binary files /dev/null and b/docs/public/ms-icon-150x150.png differ
diff --git a/docs/public/ms-icon-310x310.png b/docs/public/ms-icon-310x310.png
new file mode 100644
index 000000000..1d0051005
Binary files /dev/null and b/docs/public/ms-icon-310x310.png differ
diff --git a/docs/public/ms-icon-70x70.png b/docs/public/ms-icon-70x70.png
new file mode 100644
index 000000000..26f1b1fa5
Binary files /dev/null and b/docs/public/ms-icon-70x70.png differ
diff --git a/docs/syntax/c4c.md b/docs/syntax/c4c.md
index ebc735f3e..2d4efdd2c 100644
--- a/docs/syntax/c4c.md
+++ b/docs/syntax/c4c.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # C4 Diagrams
 
diff --git a/docs/syntax/classDiagram.md b/docs/syntax/classDiagram.md
index 02119be7e..878d9a8bd 100644
--- a/docs/syntax/classDiagram.md
+++ b/docs/syntax/classDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Class diagrams
 
diff --git a/docs/syntax/entityRelationshipDiagram.md b/docs/syntax/entityRelationshipDiagram.md
index 8ee1956e6..f6a3bb143 100644
--- a/docs/syntax/entityRelationshipDiagram.md
+++ b/docs/syntax/entityRelationshipDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Entity Relationship Diagrams
 
diff --git a/docs/syntax/examples.md b/docs/syntax/examples.md
index e0638c117..9872cd43b 100644
--- a/docs/syntax/examples.md
+++ b/docs/syntax/examples.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Examples
 
diff --git a/docs/syntax/flowchart.md b/docs/syntax/flowchart.md
index 857791a62..166a5fcc8 100644
--- a/docs/syntax/flowchart.md
+++ b/docs/syntax/flowchart.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Flowcharts - Basic Syntax
 
@@ -329,12 +329,12 @@ flowchart LR
 ### Dotted link
 
 ```mermaid-example
-flowchart LR;
+flowchart LR
    A-.->B;
 ```
 
 ```mermaid
-flowchart LR;
+flowchart LR
    A-.->B;
 ```
 
@@ -707,7 +707,7 @@ Examples of tooltip usage below:
 
 ```html
 <script>
-  var callback = function () {
+  const callback = function () {
     alert('A callback was triggered');
   };
 </script>
@@ -907,14 +907,14 @@ below:
 **Example definition**
 
 ```mermaid-example
-flowchart LR;
+flowchart LR
     A-->B[AAA<span>BBB</span>]
     B-->D
     class A cssClass
 ```
 
 ```mermaid
-flowchart LR;
+flowchart LR
     A-->B[AAA<span>BBB</span>]
     B-->D
     class A cssClass
@@ -936,7 +936,7 @@ The icons are accessed via the syntax fa:#icon class name#.
 flowchart TD
     B["fab:fa-twitter for peace"]
     B-->C[fa:fa-ban forbidden]
-    B-->D(fa:fa-spinner);
+    B-->D(fa:fa-spinner)
     B-->E(A fa:fa-camera-retro perhaps?)
 ```
 
@@ -944,7 +944,7 @@ flowchart TD
 flowchart TD
     B["fab:fa-twitter for peace"]
     B-->C[fa:fa-ban forbidden]
-    B-->D(fa:fa-spinner);
+    B-->D(fa:fa-spinner)
     B-->E(A fa:fa-camera-retro perhaps?)
 ```
 
diff --git a/docs/syntax/gantt.md b/docs/syntax/gantt.md
index ae40160f1..7e493888e 100644
--- a/docs/syntax/gantt.md
+++ b/docs/syntax/gantt.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Gantt diagrams
 
@@ -341,7 +341,7 @@ To hide the marker, set `todayMarker` to `off`.
 It is possible to adjust the margins for rendering the gantt diagram.
 
 This is done by defining the `ganttConfig` part of the configuration object.
-How to use the CLI is described in the [mermaidCLI](../config/mermaidCLI.html) page.
+How to use the CLI is described in the [mermaidCLI](../config/mermaidCLI) page.
 
 mermaid.ganttConfig can be set to a JSON string with config parameters or the corresponding object.
 
diff --git a/docs/syntax/gitgraph.md b/docs/syntax/gitgraph.md
index 0b7fcf607..68852cf42 100644
--- a/docs/syntax/gitgraph.md
+++ b/docs/syntax/gitgraph.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Gitgraph Diagrams
 
diff --git a/docs/syntax/mindmap.md b/docs/syntax/mindmap.md
index 22c41e660..00fe3b74e 100644
--- a/docs/syntax/mindmap.md
+++ b/docs/syntax/mindmap.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Mindmap
 
diff --git a/docs/syntax/pie.md b/docs/syntax/pie.md
index cd057b5e3..79dcbfee5 100644
--- a/docs/syntax/pie.md
+++ b/docs/syntax/pie.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Pie chart diagrams
 
diff --git a/docs/syntax/requirementDiagram.md b/docs/syntax/requirementDiagram.md
index b5e9a3597..d31967871 100644
--- a/docs/syntax/requirementDiagram.md
+++ b/docs/syntax/requirementDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Requirement Diagram
 
diff --git a/docs/syntax/sequenceDiagram.md b/docs/syntax/sequenceDiagram.md
index 513f3819d..73f341347 100644
--- a/docs/syntax/sequenceDiagram.md
+++ b/docs/syntax/sequenceDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # Sequence diagrams
 
diff --git a/docs/syntax/stateDiagram.md b/docs/syntax/stateDiagram.md
index 630676750..3d0c07c8a 100644
--- a/docs/syntax/stateDiagram.md
+++ b/docs/syntax/stateDiagram.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # State diagrams
 
diff --git a/docs/syntax/user-journey.md b/docs/syntax/userJourney.md
similarity index 97%
rename from docs/syntax/user-journey.md
rename to docs/syntax/userJourney.md
index 1b73bcb4c..e0d924f85 100644
--- a/docs/syntax/user-journey.md
+++ b/docs/syntax/userJourney.md
@@ -1,4 +1,4 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in docs.
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in src/docs.
 
 # User Journey Diagram
 
diff --git a/docs/vite.config.ts b/docs/vite.config.ts
index 759e437d6..bea6fe26d 100644
--- a/docs/vite.config.ts
+++ b/docs/vite.config.ts
@@ -1,5 +1,6 @@
 import { defineConfig, searchForWorkspaceRoot } from 'vite';
 import path from 'path';
+// @ts-ignore: still in alpha
 import { SearchPlugin } from 'vitepress-plugin-search';
 
 const virtualModuleId = 'virtual:mermaid-config';
@@ -29,7 +30,7 @@ export default defineConfig({
   ],
   resolve: {
     alias: {
-      mermaid: path.join(__dirname, '../dist/mermaid.esm.min.mjs'), // Use this one to build
+      mermaid: path.join(__dirname, '../../dist/mermaid.esm.min.mjs'), // Use this one to build
     },
   },
   server: {
diff --git a/packages/mermaid/.lintstagedrc.json b/packages/mermaid/.lintstagedrc.json
index d199320ef..be6e92770 100644
--- a/packages/mermaid/.lintstagedrc.json
+++ b/packages/mermaid/.lintstagedrc.json
@@ -1,6 +1,6 @@
 {
-  "packages/mermaid/docs/**": ["pnpm run docs:build --git"],
-  "packages/mermaid/docs.mts": ["pnpm run docs:build --git"],
+  "packages/mermaid/src/docs/**": ["pnpm run docs:build --git"],
+  "packages/mermaid/src/docs.mts": ["pnpm run docs:build --git"],
   "*.{ts,js,json,html,md,mts}": ["eslint --fix", "prettier --write"],
   "*.jison": ["pnpm run lint:jison"]
 }
diff --git a/packages/mermaid/docs/.vitepress/theme/custom.css b/packages/mermaid/docs/.vitepress/theme/custom.css
deleted file mode 100644
index d42052792..000000000
--- a/packages/mermaid/docs/.vitepress/theme/custom.css
+++ /dev/null
@@ -1,13 +0,0 @@
-@media (min-width: 1440px) {
-  .VPDoc:not(.has-sidebar) .container[data-v-10119189] {
-    max-width: 100%;
-  }
-
-  .VPDoc.has-aside .content-container[data-v-10119189] {
-    max-width: 100%;
-  }
-}
-
-:root {
-  --vp-layout-max-width: 100%;
-}
diff --git a/packages/mermaid/docs/edit.md b/packages/mermaid/docs/edit.md
deleted file mode 100644
index 5c623db4d..000000000
--- a/packages/mermaid/docs/edit.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-layout: home
-
-title: Live Mermaid
----
-
-<iframe id="editor" src="https://mermaid.live" style="position: fixed;left: 0px;bottom: 0px;right: 0px;top: 80px;width: 100%;height: calc(100% - 80px);"></iframe>
diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 95a9b53f1..3cad6af98 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -34,12 +34,12 @@
     "predocs:build": "rimraf docs/.vitepress/dist",
     "docs:build": "ts-node-esm src/docs.mts",
     "docs:verify": "pnpm docs:build --verify",
-    "docs:code": "typedoc --plugin typedoc-plugin-markdown --readme none --hideBreadcrumbs --hideInPageTOC --namedAnchors --out docs/config/setup --entryPointStrategy expand src/defaultConfig.ts src/config.ts src/mermaidAPI.ts",
+    "docs:code": "typedoc --plugin typedoc-plugin-markdown --readme none --hideBreadcrumbs --hideInPageTOC --namedAnchors --out src/docs/config/setup --entryPointStrategy expand src/defaultConfig.ts src/config.ts src/mermaidAPI.ts",
     "predocs:dev": "pnpm docs:code",
-    "docs:dev": "vitepress dev docs",
+    "docs:dev": "vitepress dev src/docs",
     "predocs:bundle": "pnpm docs:code",
-    "docs:bundle": "vitepress build docs",
-    "docs:serve": "vitepress serve docs",
+    "docs:bundle": "vitepress build src/docs",
+    "docs:serve": "vitepress serve src/docs",
     "release": "pnpm build",
     "lint": "eslint --cache --ignore-path .gitignore . && pnpm lint:jison && prettier --check .",
     "lint:fix": "eslint --fix --ignore-path .gitignore . && prettier --write .",
@@ -77,11 +77,7 @@
     "khroma": "^2.0.0",
     "lodash": "^4.17.21",
     "moment-mini": "^2.24.0",
-    "non-layered-tidy-tree-layout": "^2.0.2",
-    "shiki": "^0.11.1",
-    "stylis": "^4.1.2",
-    "typedoc": "^0.23.16",
-    "typedoc-plugin-markdown": "^3.13.6"
+    "non-layered-tidy-tree-layout": "^2.0.2"
   },
   "devDependencies": {
     "@applitools/eyes-cypress": "^3.25.7",
@@ -130,7 +126,11 @@
     "unist-util-flatmap": "^1.0.0",
     "vitepress": "^1.0.0-alpha.19",
     "vitepress-plugin-mermaid": "^2.0.8",
-    "vitepress-plugin-search": "^1.0.4-alpha.11"
+    "vitepress-plugin-search": "^1.0.4-alpha.11",
+    "shiki": "^0.11.1",
+    "stylis": "^4.1.2",
+    "typedoc": "^0.23.16",
+    "typedoc-plugin-markdown": "^3.13.6"
   },
   "resolutions": {
     "d3": "^7.0.0"
diff --git a/packages/mermaid/src/docs.mts b/packages/mermaid/src/docs.mts
index d350d9970..780e1d33b 100644
--- a/packages/mermaid/src/docs.mts
+++ b/packages/mermaid/src/docs.mts
@@ -47,7 +47,7 @@ const MERMAID_MAJOR_VERSION = (
 
 // These paths are from the root of the mono-repo, not from the
 // mermaid sub-directory
-const SOURCE_DOCS_DIR = 'docs';
+const SOURCE_DOCS_DIR = 'src/docs';
 const FINAL_DOCS_DIR = '../../docs';
 
 const AUTOGENERATED_TEXT = `# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in ${SOURCE_DOCS_DIR}.`;
diff --git a/packages/mermaid/docs/.vitepress/config.ts b/packages/mermaid/src/docs/.vitepress/config.ts
similarity index 95%
rename from packages/mermaid/docs/.vitepress/config.ts
rename to packages/mermaid/src/docs/.vitepress/config.ts
index 4597de900..121c4de75 100644
--- a/packages/mermaid/docs/.vitepress/config.ts
+++ b/packages/mermaid/src/docs/.vitepress/config.ts
@@ -1,4 +1,4 @@
-import { version } from '../../package.json';
+import { version } from '../../../package.json';
 import MermaidMarkdown from './mermaid-markdown-all';
 import { defineConfig } from 'vitepress';
 
@@ -8,9 +8,12 @@ export default defineConfig({
   description: 'Create diagrams and visualizations using text and code.',
   base: '/mermaid-docs/',
   markdown: MermaidMarkdown,
-  ignoreDeadLinks: true, //TODO: try to fixe those in autogenerated docs
   themeConfig: {
     nav: nav(),
+    editLink: {
+      pattern: 'https://github.com/mermaid-js/mermaid/edit/develop/docs/:path',
+      text: 'Edit this page on GitHub',
+    },
 
     sidebar: {
       '/': sidebarAll(),
@@ -53,7 +56,7 @@ function nav() {
     },
     {
       text: '💻 Live Editor',
-      link: '/edit',
+      link: 'https://mermaid.live',
     },
   ];
 }
diff --git a/packages/mermaid/docs/.vitepress/mermaid-markdown-all.ts b/packages/mermaid/src/docs/.vitepress/mermaid-markdown-all.ts
similarity index 100%
rename from packages/mermaid/docs/.vitepress/mermaid-markdown-all.ts
rename to packages/mermaid/src/docs/.vitepress/mermaid-markdown-all.ts
diff --git a/packages/mermaid/src/docs/.vitepress/theme/custom.css b/packages/mermaid/src/docs/.vitepress/theme/custom.css
new file mode 100644
index 000000000..8d5b71f56
--- /dev/null
+++ b/packages/mermaid/src/docs/.vitepress/theme/custom.css
@@ -0,0 +1,17 @@
+:root {
+  --vp-c-brand: #ff3670;
+  --vp-c-brand-light: #ff5e8c;
+  --vp-c-brand-lighter: #ff85a8;
+  --vp-c-brand-lightest: #ff9bb7;
+  --vp-c-brand-dark: #bd34fe;
+  --vp-c-brand-darker: #9339bd;
+  --vp-c-brand-dimm: rgba(100, 108, 255, 0.08);
+}
+
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe 30%, #ff3670);
+
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #bd34fe 50%, #ff3670 50%);
+  --vp-home-hero-image-filter: blur(72px);
+}
diff --git a/packages/mermaid/docs/.vitepress/theme/index.ts b/packages/mermaid/src/docs/.vitepress/theme/index.ts
similarity index 95%
rename from packages/mermaid/docs/.vitepress/theme/index.ts
rename to packages/mermaid/src/docs/.vitepress/theme/index.ts
index 7093a1643..bcce341a2 100644
--- a/packages/mermaid/docs/.vitepress/theme/index.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/index.ts
@@ -1,4 +1,5 @@
 import DefaultTheme from 'vitepress/theme';
+// @ts-ignore
 import Mermaid from 'vitepress-plugin-mermaid/Mermaid.vue';
 import './custom.css';
 
diff --git a/packages/mermaid/src/docs/CHANGELOG.md b/packages/mermaid/src/docs/CHANGELOG.md
index 7a75ad4e2..cc725bf00 100644
--- a/packages/mermaid/src/docs/CHANGELOG.md
+++ b/packages/mermaid/src/docs/CHANGELOG.md
@@ -11,10 +11,10 @@ All changes are in descending order, beginning with the newest (latest) version.
 🔖 [Release Notes](https://github.com/mermaid-js/mermaid/releases/tag/8.7.0) |
 📜 [Full Changelog](https://github.com/mermaid-js/mermaid/compare/8.6.0...8.7.0)
 
-This version brings with it a system for [dynamic and integrated configuration of the diagram themes](../config/theming.md).
+This version brings with it a system for [dynamic and integrated configuration of the diagram themes](config/theming.md).
 The objective of this is to increase the customizability of mermaid and the ease of Styling, with the customization of themes through the `%%init%%` directive and `initialize` calls.
 
-Themes follow and build upon the Levels of Configuration and employ `directives` to modify and create custom configurations, as they were introduced in Version [8.6.0](../getting-started/8.6.0_docs.md).
+Themes follow and build upon the Levels of Configuration and employ `directives` to modify and create custom configurations, as they were introduced in Version [8.6.0](config/8.6.0_docs.md).
 
 **These Theming Configurations, similar to directives, will also be made applicable in the Live-Editor, for easier styling.**
 
diff --git a/packages/mermaid/docs/community/development.md b/packages/mermaid/src/docs/community/development.md
similarity index 100%
rename from packages/mermaid/docs/community/development.md
rename to packages/mermaid/src/docs/community/development.md
diff --git a/packages/mermaid/docs/community/img/er.png b/packages/mermaid/src/docs/community/img/er.png
similarity index 100%
rename from packages/mermaid/docs/community/img/er.png
rename to packages/mermaid/src/docs/community/img/er.png
diff --git a/packages/mermaid/docs/community/n00b-overview.md b/packages/mermaid/src/docs/community/n00b-overview.md
similarity index 100%
rename from packages/mermaid/docs/community/n00b-overview.md
rename to packages/mermaid/src/docs/community/n00b-overview.md
diff --git a/packages/mermaid/docs/community/newDiagram.md b/packages/mermaid/src/docs/community/newDiagram.md
similarity index 100%
rename from packages/mermaid/docs/community/newDiagram.md
rename to packages/mermaid/src/docs/community/newDiagram.md
diff --git a/packages/mermaid/docs/community/security.md b/packages/mermaid/src/docs/community/security.md
similarity index 100%
rename from packages/mermaid/docs/community/security.md
rename to packages/mermaid/src/docs/community/security.md
diff --git a/packages/mermaid/docs/config/8.6.0_docs.md b/packages/mermaid/src/docs/config/8.6.0_docs.md
similarity index 100%
rename from packages/mermaid/docs/config/8.6.0_docs.md
rename to packages/mermaid/src/docs/config/8.6.0_docs.md
diff --git a/packages/mermaid/docs/config/Tutorials.md b/packages/mermaid/src/docs/config/Tutorials.md
similarity index 100%
rename from packages/mermaid/docs/config/Tutorials.md
rename to packages/mermaid/src/docs/config/Tutorials.md
diff --git a/packages/mermaid/docs/config/accessibility.md b/packages/mermaid/src/docs/config/accessibility.md
similarity index 100%
rename from packages/mermaid/docs/config/accessibility.md
rename to packages/mermaid/src/docs/config/accessibility.md
diff --git a/packages/mermaid/docs/config/configuration.md b/packages/mermaid/src/docs/config/configuration.md
similarity index 100%
rename from packages/mermaid/docs/config/configuration.md
rename to packages/mermaid/src/docs/config/configuration.md
diff --git a/packages/mermaid/docs/config/directives.md b/packages/mermaid/src/docs/config/directives.md
similarity index 100%
rename from packages/mermaid/docs/config/directives.md
rename to packages/mermaid/src/docs/config/directives.md
diff --git a/packages/mermaid/docs/config/img/accessibility-div-example-2.png b/packages/mermaid/src/docs/config/img/accessibility-div-example-2.png
similarity index 100%
rename from packages/mermaid/docs/config/img/accessibility-div-example-2.png
rename to packages/mermaid/src/docs/config/img/accessibility-div-example-2.png
diff --git a/packages/mermaid/docs/config/img/accessibility-div-example.png b/packages/mermaid/src/docs/config/img/accessibility-div-example.png
similarity index 100%
rename from packages/mermaid/docs/config/img/accessibility-div-example.png
rename to packages/mermaid/src/docs/config/img/accessibility-div-example.png
diff --git a/packages/mermaid/docs/config/img/assignWithDepth.png b/packages/mermaid/src/docs/config/img/assignWithDepth.png
similarity index 100%
rename from packages/mermaid/docs/config/img/assignWithDepth.png
rename to packages/mermaid/src/docs/config/img/assignWithDepth.png
diff --git a/packages/mermaid/docs/config/img/object.assign without depth.png b/packages/mermaid/src/docs/config/img/object.assign without depth.png
similarity index 100%
rename from packages/mermaid/docs/config/img/object.assign without depth.png
rename to packages/mermaid/src/docs/config/img/object.assign without depth.png
diff --git a/packages/mermaid/docs/config/img/python-mermaid-integration.png b/packages/mermaid/src/docs/config/img/python-mermaid-integration.png
similarity index 100%
rename from packages/mermaid/docs/config/img/python-mermaid-integration.png
rename to packages/mermaid/src/docs/config/img/python-mermaid-integration.png
diff --git a/packages/mermaid/docs/config/img/wrapped text.png b/packages/mermaid/src/docs/config/img/wrapped text.png
similarity index 100%
rename from packages/mermaid/docs/config/img/wrapped text.png
rename to packages/mermaid/src/docs/config/img/wrapped text.png
diff --git a/packages/mermaid/docs/config/mermaidCLI.md b/packages/mermaid/src/docs/config/mermaidCLI.md
similarity index 100%
rename from packages/mermaid/docs/config/mermaidCLI.md
rename to packages/mermaid/src/docs/config/mermaidCLI.md
diff --git a/packages/mermaid/docs/config/n00b-advanced.md b/packages/mermaid/src/docs/config/n00b-advanced.md
similarity index 100%
rename from packages/mermaid/docs/config/n00b-advanced.md
rename to packages/mermaid/src/docs/config/n00b-advanced.md
diff --git a/packages/mermaid/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
similarity index 100%
rename from packages/mermaid/docs/config/theming.md
rename to packages/mermaid/src/docs/config/theming.md
diff --git a/packages/mermaid/docs/config/usage.md b/packages/mermaid/src/docs/config/usage.md
similarity index 100%
rename from packages/mermaid/docs/config/usage.md
rename to packages/mermaid/src/docs/config/usage.md
diff --git a/packages/mermaid/src/docs/img/er.png b/packages/mermaid/src/docs/img/er.png
new file mode 100644
index 000000000..21c44c257
Binary files /dev/null and b/packages/mermaid/src/docs/img/er.png differ
diff --git a/packages/mermaid/docs/index.md b/packages/mermaid/src/docs/index.md
similarity index 98%
rename from packages/mermaid/docs/index.md
rename to packages/mermaid/src/docs/index.md
index bc3d4b741..be85bc242 100644
--- a/packages/mermaid/docs/index.md
+++ b/packages/mermaid/src/docs/index.md
@@ -9,7 +9,7 @@ hero:
   text: Diagramming and charting tool
   tagline: JavaScript based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically.
   image:
-    src: /header.png
+    src: /mermaid-logo.svg
     alt: Mermaid
   actions:
     - theme: brand
@@ -105,6 +105,7 @@ const members = [
   .image-container .image-src {
     margin: 1rem auto;
     max-width: 100%;
+    width: 100%;
   }
 
   .dark .image-src{
diff --git a/packages/mermaid/docs/intro/img/Code-Preview-Config.png b/packages/mermaid/src/docs/intro/img/Code-Preview-Config.png
similarity index 100%
rename from packages/mermaid/docs/intro/img/Code-Preview-Config.png
rename to packages/mermaid/src/docs/intro/img/Code-Preview-Config.png
diff --git a/packages/mermaid/docs/intro/img/Live-Editor-Choices.png b/packages/mermaid/src/docs/intro/img/Live-Editor-Choices.png
similarity index 100%
rename from packages/mermaid/docs/intro/img/Live-Editor-Choices.png
rename to packages/mermaid/src/docs/intro/img/Live-Editor-Choices.png
diff --git a/packages/mermaid/docs/intro/img/book-banner-post-release.jpg b/packages/mermaid/src/docs/intro/img/book-banner-post-release.jpg
similarity index 100%
rename from packages/mermaid/docs/intro/img/book-banner-post-release.jpg
rename to packages/mermaid/src/docs/intro/img/book-banner-post-release.jpg
diff --git a/packages/mermaid/docs/intro/index.md b/packages/mermaid/src/docs/intro/index.md
similarity index 99%
rename from packages/mermaid/docs/intro/index.md
rename to packages/mermaid/src/docs/intro/index.md
index 063ee9ef9..c65ed1830 100644
--- a/packages/mermaid/docs/intro/index.md
+++ b/packages/mermaid/src/docs/intro/index.md
@@ -131,7 +131,7 @@ erDiagram
 
 ```
 
-### [User Journey Diagram](../syntax/user-journey.md)
+### [User Journey Diagram](../syntax/userJourney.md)
 
 ```mermaid-example
 journey
diff --git a/packages/mermaid/docs/intro/n00b-gettingStarted.md b/packages/mermaid/src/docs/intro/n00b-gettingStarted.md
similarity index 100%
rename from packages/mermaid/docs/intro/n00b-gettingStarted.md
rename to packages/mermaid/src/docs/intro/n00b-gettingStarted.md
diff --git a/packages/mermaid/docs/intro/n00b-syntaxReference.md b/packages/mermaid/src/docs/intro/n00b-syntaxReference.md
similarity index 100%
rename from packages/mermaid/docs/intro/n00b-syntaxReference.md
rename to packages/mermaid/src/docs/intro/n00b-syntaxReference.md
diff --git a/packages/mermaid/docs/misc/faq.md b/packages/mermaid/src/docs/misc/faq.md
similarity index 100%
rename from packages/mermaid/docs/misc/faq.md
rename to packages/mermaid/src/docs/misc/faq.md
diff --git a/packages/mermaid/docs/misc/integrations.md b/packages/mermaid/src/docs/misc/integrations.md
similarity index 100%
rename from packages/mermaid/docs/misc/integrations.md
rename to packages/mermaid/src/docs/misc/integrations.md
diff --git a/packages/mermaid/docs/public/.nojekyll b/packages/mermaid/src/docs/public/.nojekyll
similarity index 100%
rename from packages/mermaid/docs/public/.nojekyll
rename to packages/mermaid/src/docs/public/.nojekyll
diff --git a/packages/mermaid/src/docs/public/android-icon-144x144.png b/packages/mermaid/src/docs/public/android-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-144x144.png differ
diff --git a/packages/mermaid/src/docs/public/android-icon-192x192.png b/packages/mermaid/src/docs/public/android-icon-192x192.png
new file mode 100644
index 000000000..5f6c40128
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-192x192.png differ
diff --git a/packages/mermaid/src/docs/public/android-icon-36x36.png b/packages/mermaid/src/docs/public/android-icon-36x36.png
new file mode 100644
index 000000000..40b1140fa
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-36x36.png differ
diff --git a/packages/mermaid/src/docs/public/android-icon-48x48.png b/packages/mermaid/src/docs/public/android-icon-48x48.png
new file mode 100644
index 000000000..c81790b84
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-48x48.png differ
diff --git a/packages/mermaid/src/docs/public/android-icon-72x72.png b/packages/mermaid/src/docs/public/android-icon-72x72.png
new file mode 100644
index 000000000..1866eb50e
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-72x72.png differ
diff --git a/packages/mermaid/src/docs/public/android-icon-96x96.png b/packages/mermaid/src/docs/public/android-icon-96x96.png
new file mode 100644
index 000000000..c2a1e3dc8
Binary files /dev/null and b/packages/mermaid/src/docs/public/android-icon-96x96.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-114x114.png b/packages/mermaid/src/docs/public/apple-icon-114x114.png
new file mode 100644
index 000000000..ba11f97b1
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-114x114.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-120x120.png b/packages/mermaid/src/docs/public/apple-icon-120x120.png
new file mode 100644
index 000000000..05f58d801
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-120x120.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-144x144.png b/packages/mermaid/src/docs/public/apple-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-144x144.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-152x152.png b/packages/mermaid/src/docs/public/apple-icon-152x152.png
new file mode 100644
index 000000000..f5a82583c
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-152x152.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-180x180.png b/packages/mermaid/src/docs/public/apple-icon-180x180.png
new file mode 100644
index 000000000..752c4dcf6
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-180x180.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-57x57.png b/packages/mermaid/src/docs/public/apple-icon-57x57.png
new file mode 100644
index 000000000..653687ee2
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-57x57.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-60x60.png b/packages/mermaid/src/docs/public/apple-icon-60x60.png
new file mode 100644
index 000000000..e27a4529b
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-60x60.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-72x72.png b/packages/mermaid/src/docs/public/apple-icon-72x72.png
new file mode 100644
index 000000000..4c05a3c1b
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-72x72.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-76x76.png b/packages/mermaid/src/docs/public/apple-icon-76x76.png
new file mode 100644
index 000000000..4dae6668d
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-76x76.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon-precomposed.png b/packages/mermaid/src/docs/public/apple-icon-precomposed.png
new file mode 100644
index 000000000..620c2b691
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon-precomposed.png differ
diff --git a/packages/mermaid/src/docs/public/apple-icon.png b/packages/mermaid/src/docs/public/apple-icon.png
new file mode 100644
index 000000000..620c2b691
Binary files /dev/null and b/packages/mermaid/src/docs/public/apple-icon.png differ
diff --git a/packages/mermaid/src/docs/public/browserconfig.xml b/packages/mermaid/src/docs/public/browserconfig.xml
new file mode 100644
index 000000000..c55414822
--- /dev/null
+++ b/packages/mermaid/src/docs/public/browserconfig.xml
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig><msapplication><tile><square70x70logo src="/ms-icon-70x70.png"/><square150x150logo src="/ms-icon-150x150.png"/><square310x310logo src="/ms-icon-310x310.png"/><TileColor>#ffffff</TileColor></tile></msapplication></browserconfig>
\ No newline at end of file
diff --git a/packages/mermaid/src/docs/public/favicon-16x16.png b/packages/mermaid/src/docs/public/favicon-16x16.png
new file mode 100644
index 000000000..238b81faf
Binary files /dev/null and b/packages/mermaid/src/docs/public/favicon-16x16.png differ
diff --git a/packages/mermaid/src/docs/public/favicon-32x32.png b/packages/mermaid/src/docs/public/favicon-32x32.png
new file mode 100644
index 000000000..7df5e64fc
Binary files /dev/null and b/packages/mermaid/src/docs/public/favicon-32x32.png differ
diff --git a/packages/mermaid/src/docs/public/favicon-96x96.png b/packages/mermaid/src/docs/public/favicon-96x96.png
new file mode 100644
index 000000000..c2a1e3dc8
Binary files /dev/null and b/packages/mermaid/src/docs/public/favicon-96x96.png differ
diff --git a/packages/mermaid/src/docs/public/favicon.ico b/packages/mermaid/src/docs/public/favicon.ico
new file mode 100644
index 000000000..d41818c5b
Binary files /dev/null and b/packages/mermaid/src/docs/public/favicon.ico differ
diff --git a/packages/mermaid/docs/public/header.png b/packages/mermaid/src/docs/public/header.png
similarity index 100%
rename from packages/mermaid/docs/public/header.png
rename to packages/mermaid/src/docs/public/header.png
diff --git a/packages/mermaid/src/docs/public/manifest.json b/packages/mermaid/src/docs/public/manifest.json
new file mode 100644
index 000000000..3b557aab8
--- /dev/null
+++ b/packages/mermaid/src/docs/public/manifest.json
@@ -0,0 +1,41 @@
+{
+  "name": "App",
+  "icons": [
+    {
+      "src": "/android-icon-36x36.png",
+      "sizes": "36x36",
+      "type": "image/png",
+      "density": "0.75"
+    },
+    {
+      "src": "/android-icon-48x48.png",
+      "sizes": "48x48",
+      "type": "image/png",
+      "density": "1.0"
+    },
+    {
+      "src": "/android-icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "density": "1.5"
+    },
+    {
+      "src": "/android-icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "density": "2.0"
+    },
+    {
+      "src": "/android-icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "density": "3.0"
+    },
+    {
+      "src": "/android-icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "density": "4.0"
+    }
+  ]
+}
diff --git a/packages/mermaid/src/docs/public/mermaid-logo.svg b/packages/mermaid/src/docs/public/mermaid-logo.svg
new file mode 100644
index 000000000..5ac259968
--- /dev/null
+++ b/packages/mermaid/src/docs/public/mermaid-logo.svg
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 491 491" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <!-- <path d="M490.16,84.61C490.16,37.912 452.248,0 405.55,0L84.61,0C37.912,0 0,37.912 0,84.61L0,405.55C0,452.248 37.912,490.16 84.61,490.16L405.55,490.16C452.248,490.16 490.16,452.248 490.16,405.55L490.16,84.61Z" style="fill:rgb(255,54,112);"/> -->
+    <path d="M407.48,111.18C335.587,108.103 269.573,152.338 245.08,220C220.587,152.338 154.573,108.103 82.68,111.18C80.285,168.229 107.577,222.632 154.74,254.82C178.908,271.419 193.35,298.951 193.27,328.27L193.27,379.13L296.9,379.13L296.9,328.27C296.816,298.953 311.255,271.42 335.42,254.82C382.596,222.644 409.892,168.233 407.48,111.18Z" style="fill:white;fill-rule:nonzero;"/>
+</svg>
diff --git a/packages/mermaid/src/docs/public/ms-icon-144x144.png b/packages/mermaid/src/docs/public/ms-icon-144x144.png
new file mode 100644
index 000000000..2e2f24bba
Binary files /dev/null and b/packages/mermaid/src/docs/public/ms-icon-144x144.png differ
diff --git a/packages/mermaid/src/docs/public/ms-icon-150x150.png b/packages/mermaid/src/docs/public/ms-icon-150x150.png
new file mode 100644
index 000000000..1785c0f1a
Binary files /dev/null and b/packages/mermaid/src/docs/public/ms-icon-150x150.png differ
diff --git a/packages/mermaid/src/docs/public/ms-icon-310x310.png b/packages/mermaid/src/docs/public/ms-icon-310x310.png
new file mode 100644
index 000000000..1d0051005
Binary files /dev/null and b/packages/mermaid/src/docs/public/ms-icon-310x310.png differ
diff --git a/packages/mermaid/src/docs/public/ms-icon-70x70.png b/packages/mermaid/src/docs/public/ms-icon-70x70.png
new file mode 100644
index 000000000..26f1b1fa5
Binary files /dev/null and b/packages/mermaid/src/docs/public/ms-icon-70x70.png differ
diff --git a/packages/mermaid/docs/syntax/c4c.md b/packages/mermaid/src/docs/syntax/c4c.md
similarity index 100%
rename from packages/mermaid/docs/syntax/c4c.md
rename to packages/mermaid/src/docs/syntax/c4c.md
diff --git a/packages/mermaid/docs/syntax/classDiagram.md b/packages/mermaid/src/docs/syntax/classDiagram.md
similarity index 100%
rename from packages/mermaid/docs/syntax/classDiagram.md
rename to packages/mermaid/src/docs/syntax/classDiagram.md
diff --git a/packages/mermaid/docs/syntax/entityRelationshipDiagram.md b/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
similarity index 100%
rename from packages/mermaid/docs/syntax/entityRelationshipDiagram.md
rename to packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
diff --git a/packages/mermaid/docs/syntax/examples.md b/packages/mermaid/src/docs/syntax/examples.md
similarity index 100%
rename from packages/mermaid/docs/syntax/examples.md
rename to packages/mermaid/src/docs/syntax/examples.md
diff --git a/packages/mermaid/docs/syntax/flowchart.md b/packages/mermaid/src/docs/syntax/flowchart.md
similarity index 99%
rename from packages/mermaid/docs/syntax/flowchart.md
rename to packages/mermaid/src/docs/syntax/flowchart.md
index 41ed2500a..09960a927 100644
--- a/packages/mermaid/docs/syntax/flowchart.md
+++ b/packages/mermaid/src/docs/syntax/flowchart.md
@@ -207,7 +207,7 @@ flowchart LR
 ### Dotted link
 
 ```mermaid-example
-flowchart LR;
+flowchart LR
    A-.->B;
 ```
 
@@ -449,7 +449,7 @@ Examples of tooltip usage below:
 
 ```html
 <script>
-  var callback = function () {
+  const callback = function () {
     alert('A callback was triggered');
   };
 </script>
@@ -617,7 +617,7 @@ below:
 **Example definition**
 
 ```mermaid-example
-flowchart LR;
+flowchart LR
     A-->B[AAA<span>BBB</span>]
     B-->D
     class A cssClass
@@ -641,7 +641,7 @@ The icons are accessed via the syntax fa:#icon class name#.
 flowchart TD
     B["fab:fa-twitter for peace"]
     B-->C[fa:fa-ban forbidden]
-    B-->D(fa:fa-spinner);
+    B-->D(fa:fa-spinner)
     B-->E(A fa:fa-camera-retro perhaps?)
 ```
 
diff --git a/packages/mermaid/docs/syntax/gantt.md b/packages/mermaid/src/docs/syntax/gantt.md
similarity index 99%
rename from packages/mermaid/docs/syntax/gantt.md
rename to packages/mermaid/src/docs/syntax/gantt.md
index 435d892c6..755f50b1e 100644
--- a/packages/mermaid/docs/syntax/gantt.md
+++ b/packages/mermaid/src/docs/syntax/gantt.md
@@ -275,7 +275,7 @@ todayMarker off
 It is possible to adjust the margins for rendering the gantt diagram.
 
 This is done by defining the `ganttConfig` part of the configuration object.
-How to use the CLI is described in the [mermaidCLI](../config/mermaidCLI.html) page.
+How to use the CLI is described in the [mermaidCLI](../config/mermaidCLI) page.
 
 mermaid.ganttConfig can be set to a JSON string with config parameters or the corresponding object.
 
diff --git a/packages/mermaid/docs/syntax/gitgraph.md b/packages/mermaid/src/docs/syntax/gitgraph.md
similarity index 100%
rename from packages/mermaid/docs/syntax/gitgraph.md
rename to packages/mermaid/src/docs/syntax/gitgraph.md
diff --git a/packages/mermaid/docs/syntax/img/Gantt-excluded-days-within.png b/packages/mermaid/src/docs/syntax/img/Gantt-excluded-days-within.png
similarity index 100%
rename from packages/mermaid/docs/syntax/img/Gantt-excluded-days-within.png
rename to packages/mermaid/src/docs/syntax/img/Gantt-excluded-days-within.png
diff --git a/packages/mermaid/docs/syntax/img/Gantt-long-weekend-look.png b/packages/mermaid/src/docs/syntax/img/Gantt-long-weekend-look.png
similarity index 100%
rename from packages/mermaid/docs/syntax/img/Gantt-long-weekend-look.png
rename to packages/mermaid/src/docs/syntax/img/Gantt-long-weekend-look.png
diff --git a/packages/mermaid/docs/syntax/mindmap.md b/packages/mermaid/src/docs/syntax/mindmap.md
similarity index 100%
rename from packages/mermaid/docs/syntax/mindmap.md
rename to packages/mermaid/src/docs/syntax/mindmap.md
diff --git a/packages/mermaid/docs/syntax/pie.md b/packages/mermaid/src/docs/syntax/pie.md
similarity index 100%
rename from packages/mermaid/docs/syntax/pie.md
rename to packages/mermaid/src/docs/syntax/pie.md
diff --git a/packages/mermaid/docs/syntax/requirementDiagram.md b/packages/mermaid/src/docs/syntax/requirementDiagram.md
similarity index 100%
rename from packages/mermaid/docs/syntax/requirementDiagram.md
rename to packages/mermaid/src/docs/syntax/requirementDiagram.md
diff --git a/packages/mermaid/docs/syntax/sequenceDiagram.md b/packages/mermaid/src/docs/syntax/sequenceDiagram.md
similarity index 100%
rename from packages/mermaid/docs/syntax/sequenceDiagram.md
rename to packages/mermaid/src/docs/syntax/sequenceDiagram.md
diff --git a/packages/mermaid/docs/syntax/stateDiagram.md b/packages/mermaid/src/docs/syntax/stateDiagram.md
similarity index 100%
rename from packages/mermaid/docs/syntax/stateDiagram.md
rename to packages/mermaid/src/docs/syntax/stateDiagram.md
diff --git a/packages/mermaid/docs/syntax/user-journey.md b/packages/mermaid/src/docs/syntax/userJourney.md
similarity index 100%
rename from packages/mermaid/docs/syntax/user-journey.md
rename to packages/mermaid/src/docs/syntax/userJourney.md
diff --git a/packages/mermaid/docs/vite.config.ts b/packages/mermaid/src/docs/vite.config.ts
similarity index 89%
rename from packages/mermaid/docs/vite.config.ts
rename to packages/mermaid/src/docs/vite.config.ts
index 759e437d6..bea6fe26d 100644
--- a/packages/mermaid/docs/vite.config.ts
+++ b/packages/mermaid/src/docs/vite.config.ts
@@ -1,5 +1,6 @@
 import { defineConfig, searchForWorkspaceRoot } from 'vite';
 import path from 'path';
+// @ts-ignore: still in alpha
 import { SearchPlugin } from 'vitepress-plugin-search';
 
 const virtualModuleId = 'virtual:mermaid-config';
@@ -29,7 +30,7 @@ export default defineConfig({
   ],
   resolve: {
     alias: {
-      mermaid: path.join(__dirname, '../dist/mermaid.esm.min.mjs'), // Use this one to build
+      mermaid: path.join(__dirname, '../../dist/mermaid.esm.min.mjs'), // Use this one to build
     },
   },
   server: {