showdown-highlight

A Showdown extension for highlight the code blocks.

This package uses highlight.js to highlight code blocks in Showdown output. :rocket:

:cloud: Installation

1# Using npm
2npm install --save showdown-highlight
3
4# Using yarn
5yarn add showdown-highlight

:clipboard: Example

1const showdown = require('showdown')
2    , showdownHighlight = require("showdown-highlight")
3    ;
4
5// After requiring the module, use it as extension
6let converter = new showdown.Converter({
7    // That's it
8    extensions: [showdownHighlight({
9        // Whether to add the classes to the <pre> tag, default is false
10        pre: true
11        // Whether to use hljs' auto language detection, default is true
12    ,   auto_detection: true
13    })]
14});
15
16// Now you can Highlight code blocks
17let html = converter.makeHtml(`
18## Highlighting Code with Showdown
19
20Below we have a piece of JavaScript code:
21
22\`\`\`js
23function sayHello (msg, who) {
24    return \`\${who} says: msg\`;
25}
26sayHello("Hello World", "Johnny");
27\`\`\`
28`);
29
30console.log(html);
31// <h2 id="highlightingcodewithshowdown">Highlighting Code with Showdown</h2>
32//
33// <p>Below we have a piece of JavaScript code:</p>
34//
35// <pre><code class="js language-js"><span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">sayHello</span> (<span class="hljs-params">msg, who</span>) </span>{
36//     <span class="hljs-keyword">return</span> <span class="hljs-string">`<span class="hljs-subst">${who}</span> says: msg`</span>;
37// }
38// sayHello(<span class="hljs-string">"Hello World"</span>, <span class="hljs-string">"Johnny"</span>);
39// </code></pre>

:question: Get Help

There are few ways to get help:

1. Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
2. For bug reports and feature requests, open issues. :bug:

:memo: Documentation

showdownHighlight()

Highlight the code in the showdown input.

Examples:

1let converter = new showdown.Converter({
2    extensions: [showdownHighlight]
3})

Enable the classes in the <pre> element:

1let converter = new showdown.Converter({
2    extensions: [showdownHighlight({ pre: true })]
3})

If you want to disable language auto detection feature of hljs, change auto_detection flag as false. With this option turned off, showdown-highlight will not process any codeblocks with no language specified.

1let converter = new showdown.Converter({
2    extensions: [showdownHighlight({ auto_detection: false })]
3})

:yum: How to contribute

Have an idea? Found a bug? See how to contribute.

:dizzy: Where is this library used?

If you are using this library in one of your projects, add it in this list. :sparkles:

• mdpdf
• bloggify-markdown-highlight
• github-readme-to-html
• md-toy-blog
• @kev_nz/publisher
• @etermind/alex
• @siradoc/siradoc
• @web-native-js/chtml-cli
• swanky
• md-srv
• docset-tools-markdown
• callete
• teroshdl2
• ui_kitchenadmincenter
• trumpdoc
• @peersky/next-web3-chakra
• mdpdf_jm
• textbase
• teroshdl
• showdown-html
• busi-ui
• md-browse
• markdown2dash
• tutors-reader-lib
• tutors-html-beta
• tutors-html
• examma-ray
• steelsky
• chimpsky
• ember-showdown-highlight
• showit
• tutors-html-alpha

:scroll: License

MIT © Bloggify