markdown2html-pro

GitHub Status


NPM Status


A parser of Markdown and a render to html, written in typescript, that aims for preview-code , which is published as an extension on Visual Studio Code to preview Markdown, ReStructured Text, HTML, Jade, Pug or Mermaid files, Image's URI or CSS while editing them in VSCode.

It is built on top of [markdown-it],
a [CommonMark] markdown parser. You can use markdown2html-pro:

markdown2html-pro is the thing that parses package READMEs on
http://www.npmjs.com. If you see a markdown parsing bug there,
[file an issue here]!

[file an issue here]: https://github.com/searKing/markdown2html-pro/issues
[GitHub-style markdown]: https://help.github.com/articles/basic-writing-and-formatting-syntax/
[CommonMark]: http://spec.commonmark.org/
[markdown-it]: https://github.com/markdown-it/markdown-it
[programmatically in NodeJS]: #Using this module in other modules

README

\ tag plugin for markdown-it markdown parser. Generation of diagrams, flowcharts, gants and sequences from text.

Installation

``sh
npm install markdown2html-pro --save
`

Using this module in other modules

Here is a quick example of how this module can be used in other modules. The TypeScript Module Resolution Logic makes it quite easy. The file src/index.ts is a barrel that re-exports selected exports from other files. The _package.json_ file contains main attribute that points to the generated lib/index.js file and typings attribute that points to the generated lib/index.d.ts file.

> If you are planning to have code in multiple files (which is quite natural for a NodeJS module) that users can import, make sure you update src/index.ts file appropriately.

Now assuming you have published this amazing module to _npm_ with the name markdown2html-pro, and installed it in the module in which you need it -

- To use the mermaid2html function in a TypeScript file -

`ts
import markdownItMermaidPro = require('markdown-it-mermaid-pro');
const taskList: string =
\\\mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
\\\
;

(async (md: string) => {
const defaultRootWebPath = path.join(__dirname, '..');
// console.log('defaultRootWebPath= ', defaultRootWebPath);
const options: index.IMermaid2htmlProOptions = {
rootWebPath: defaultRootWebPath,
};

const html: string = await markdownItMermaidPro.mermaid2html(md, options);
console.log("rendered html is\n:", html);

return;
})(taskList);
`

- To use the mermaid2html function in a JavaScript file -

`js
const markdownItMermaidPro = require("markdown-it-mermaid-pro")
const mermaid2html = markdownItMermaidPro.mermaid2html;
const taskList =
\\\mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
\\\
;
(async(md)=>{
const options = {
rootWebPath: defaultRootWebPath,
};
const html = await mermaid2html(md, options);
console.log("rendered html is\n:", html);
})(taskList)
`

- To use the mermaid2html function in a TypeScript file as a markdown-it plugin-

`ts
import markdownItMermaidPro = require('markdown-it-mermaid-pro');
const taskList: string =
\\\mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
\\\
;
(async (markdownContent: string) => {
let html: string = '';

if (typeof markdownContent !== 'string') {
throw Error('first argument must be a string');
}
const defaultRootWebPath = path.join(__dirname, '..');

const cms: string[] = await markdownItMermaidPro.mermaid_pro_plugin_init_everytime(
markdownContent,
defaultRootWebPath
);
const md = require('markdown-it')();
const ro = {
contentMaps: cms,
};
md.use(markdownItMermaidPro, ro);

html = md.render(markdownContent);
console.log('html = ', html);
return html;
})(taskList);
`

- To use the mermaid2html function in a JavaScript file as a markdown-it plugin-

`js
const markdownItMermaidPro = require("markdown-it-mermaid-pro")
const taskList =
\\\mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
\\\
;
(async (markdownContent: string) => {
let html: string = '';

if (typeof markdownContent !== 'string') {
throw Error('first argument must be a string');
}
const defaultRootWebPath = path.join(__dirname, '..');

const cms: string[] = await markdownItMermaidPro.mermaid_pro_plugin_init_everytime(
markdownContent,
defaultRootWebPath
);
const md = require('markdown-it')();
const ro = {
contentMaps: cms,
};
md.use(markdownItMermaidPro, ro);

html = md.render(markdownContent);
console.log('html = ', html);
return html;
})(taskList);
`




Setting travis and coveralls badges

1. Sign in to travis and activate the build for your project.
2. Sign in to coveralls and activate the build for your project.
3. Replace searKing/markdown2html-pro with your repo details like: "ospatil/generator-node-typescript".

Programmatic Usage

markdown2html-pro exports a single function. For basic use, that function
takes a single argument: a string to convert.

`js
const mermaid2html = require("markdown2html-pro")
const html : Promise = mermaid2html("# hello, I'm markdown")
`

Tests

`sh
npm install
npm test
``

Thanks to

+ marky-markdown.