md2bbc.js
Markdown is cool. But forums only support bbcode.
Is there a way to use markdown in forum?
With this question, this tool is developed.
Plugin for marked that convert markdown to bbcode.
To Users
Hey! I am online and ready to use. Check the deployed version here.
Install
npm install --save md2bbc marked
if you are using node.js or browserify, or;
bower install --save md2bbc marked
if you want to use this in browser.
This support node.js require, browserify, AMD(though I don't know how to use it) and <script>
Usage
Node.js/browserify:
let marked = ;let md2bbc = ; console; // Or, set default renderer to md2bbcmarked;console; // Both will log [div][b]Markdown[/b] is awesome.[/div]
Browser:
Marked in the browser
Options
Type: Object
Reminder: Do not set option in md2bbc constructor. Instead, set them in marked option.
I.E.
let marked = ;let md2bbc = ; marked
Warning: Options does not perform type check. Make sure you have passed in correct type.
Options contains the following keys:
paragraphTag
Type: String
Default: div
The tag name for paragraph tag.
If ''
is passed in, no tag will be inserted for paragraph
tableAttr
Type String
Default: ''
Attribute for table. For example, width and broder of the table, if your implementation of BBcode is supported.
If ''
is passed in, no attribute will be added.
Do not add space before it.
tableAlign
Type: Boolean
Default: true
Enable align for table(or table cell, if you like)
Overriding
You may override any function you want by doing the followings:
let marked = ;let md2bbc = ; // Create a new instance of md2bbc rendererlet renderer = ; // Override html renderingrenderer { return ''}; marked;
(Methods can be found from here)
Reminder
Not all bbcode implementation got all features. For example, some does not have code
tag. Please either ask forum master to implement that as this is somewhat a bug form their side. I write this base on the implementation of gamer.com.tw(Chinese site).
Running tests on node.js
- Clone this repository
- Run
npm install
- Run
npm test
Build it
Building this will minify the javascript and create a sourcemap for it.
- Install gulp globally by
npm install -g gulp
- Run
npm install
- Run
gulp
- Built javascript will be in dist/