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.
Hey! I am online and ready to use. Check the deployed version here.
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>
Node.js/browserify:
let marked = require('marked');
let md2bbc = require('md2bbc');
console.log(marked('**Markdown** is awesome.', {
renderer: new md2bbc()
}));
// Or, set default renderer to md2bbc
marked.setOptions({
renderer: new md2bbc()
});
console.log(marked('**Markdown** is awesome.'));
// Both will log [div][b]Markdown[/b] is awesome.[/div]Browser:
<!doctype html>
<html>
<head>
<title>Marked in the browser</title>
<script src="bower_components/marked/dist/marked.js"></script>
<script src="bower_components/md2bbc/dist/md2bbc.min.js"></script>
</head>
<body>
<script>
marked.setOptions({
renderer: new md2bbc()
});
console.log(marked('**Markdown** is awesome.'));
</script>
</body>
</html>Type: Object
Reminder: Do not set option in md2bbc constructor. Instead, set them in marked option.
I.E.
let marked = require('marked');
let md2bbc = require('md2bbc');
marked.setOptions({
renderer: new md2bbc(),
paragraphTag: 'div',
tableAttr: 'width=98% broder=1'
})Warning: Options does not perform type check. Make sure you have passed in correct type.
Options contains the following keys:
Type: String
Default: div
The tag name for paragraph tag.
If '' is passed in, no tag will be inserted for paragraph
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.
Type: Boolean
Default: true
Enable align for table(or table cell, if you like)
You may override any function you want by doing the followings:
let marked = require('marked');
let md2bbc = require('md2bbc');
// Create a new instance of md2bbc renderer
let renderer = new md2bbc();
// Override html rendering
renderer.html = html => {
return ''
};
marked.setOptions({
renderer: renderer
});(Methods can be found from here)
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).
- Clone this repository
- Run
npm install - Run
npm test
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/