Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Prime Transformer semver 2.0.0 compliant

Prime Transformer is a BBCode parser and transformation library. Additional implementations may be added support additional source or target markup languages. The parser returns a light weight document object model of the source BBCode consisting mostly of index values and offsets that can be utilized by the transformer.

Prime Transformer is actively developed and is being utilized in high performance commercial products.

String source = "[b]Hello World![/b]";
Document document = new BBCodeParser().buildDocument(source, null);
String html = new BBCodeToHTMLTransformer().transform(document, (node) -> {
  // transform predicate, returning false will cause this node to not be transformed
  return true;
}, new HTMLTransformFunction(), null);

Assert.assertEquals(html, "<strong>Hello World!</strong>");

In the above example, we also provided a transform function as the third parameter. This parameter is optional, but most users will wish to escape HTML characters. This function is provided in the library, the caller can provide their own implementation as well.

  • Written in Java 8
  • No regular expressions, implementation uses a finite state machine... it's fast
  • Supports tag attributes
  • Tag does not require a closing tag. (e.g. [*])
  • Tag has a pre-formatted body (e.g. [code] or [noparse])
  • Supports escape character.
  • Normal: [b]foo\[/b] --> foo
  • Escaped: \[b]foo\[/b] --> [b]foo[/b]

Download from Maven


Building in Maven

$ mvn install

Downloading from Savant

Released versions can be downloaded from the Savant Repository.

Building in Savant

Note: This project uses the Savant build tool. To compile using using Savant, follow these instructions:

$ mkdir ~/savant
$ cd ~/savant
$ wget
$ tar xvfz savant-1.0.0.tar.gz
$ ln -s ./savant-1.0.0 current
$ export PATH=$PATH:~/savant/current/bin/

Then, perform an integration build of the project by running:

$ sb int

For more information, checkout