Skip to content

A NodeBB plugin to extend markdown with new feature as tooltip, anchor, custom text header with background, etc.

License

Notifications You must be signed in to change notification settings

MinecraftForgeFrance/nodebb-plugin-extended-markdown

Repository files navigation

nodebb-plugin-extended-markdown

A NodeBB plugin to extend markdown with new feature as tooltip, anchor, custom text header with background, color, code block with multiple languages and text align.

Installation

npm install nodebb-plugin-extended-markdown

Use

Color

A color picker is available in the composer:

Color picker The syntaxe is: %(#hexColorCode)[colored text]

Text align

You can align right by adding -| at the end of your paragraph. Likewise, you can align left a text by adding |- at the beginning of your paragraph. Combining the two will center the text.

Align You can also justify your paragraph by adding |= at the beginning and =| at the end.

/!\ Warning, text align is applied on the whole paragraph, so this will not work:

|-This text won't be centered because the ending tag is at the end of the line instead of the end of the paragraph.-|
This is still the same paragraph! You need to add two new lines to start a new paragraph

Spoiler

A simple spoiler with the same syntax as Discord: ||hidden text||

Spoiler

Tooltip

Tooltip allow you to add a hover-text on another text. The syntax is °text°(tooltip text). You can use fa-info as text, in this case it will use fa-info icon:

Tooltip

Anchor

All heading (h1, h2, etc., # in markdown) will automatically have an anchor using a slug (specials chars like :, , are removed, space are replaced by a -). You can then create a link to this anchor with the usual markdown syntax: [link name](#anchor-name)

Text heading with background

Specially added for Minecraft Forge France's tutorials, this one is a h2 with a background. You can add it with #anchor-name(title) where anchor-name is the name of the anchor. You can then create a link to this anchor with the usual markdown syntax: [link name](#anchor-name)

Heading with background

You can override the style using custom css:

.text-header {
    background-color: anotherColor;
}

(Admin cp -> Appearance -> Custom Content -> Custom CSS/SASS).

Grouped code

Also added for the needs of our tutorials, it allows showing multiples languages with nice tabs. The syntax is a bit complex:

===group
\```python
print("Hello world!")
\```
\```javascript
console.log("Hello world!")
\```
===

And the result:

Grouped code

You can add more than two languages.

Note

Enable to emphasise some element with a nice design

!!! info [Title]: A simple note

!!! important [Title]: An important note

!!! warning [Title]: A warning note
Can be in multiple line !

And the result;

Note

You can change the colors by override the css:

.admonition.important { 
    background: #c0f2e8;
}
.admonition.important .admonition-title {
    background: #7de8d2;
}
.admonition.info { 
    background: #c0dcf2;
}
.admonition.info .admonition-title { 
    background: #7dbae8;
}
.admonition.warning { 
    background:#f2d9c0;
}
.admonition.warning .admonition-title {
    background:#e8b37d;
}

(Admin cp -> Appearance -> Custom Content -> Custom CSS/SASS).

About

A NodeBB plugin to extend markdown with new feature as tooltip, anchor, custom text header with background, etc.

Resources

License

Stars

Watchers

Forks

Packages

No packages published