Skip to content

enonic/lib-markdown

Repository files navigation

Markdown library for Enonic XP

Actions Status codecov License

This is a library for rendering markdown in Enonic XP. It exposes a single function render that renders markdown to html. The library uses CommonMark-Java for the actual processing.

Compatibility

Version  XP Version  Dependency
1.0.0 7.0.0 com.enonic.lib:lib-markdown:1.0.0
0.5.0 6.7.x, 6.8.x com.enonic.lib:lib-markdown:0.5.0

Usage

First, you will need to add Enonic repository to the repository list:

repositories {
    maven {
        url 'http://repo.enonic.com/public'
    }
}

After this, add the following dependency (where <version> is the actual version to use):

dependencies {
    include 'com.enonic.lib:lib-markdown:<version>'
}

Example

Here's a simple example rendering markdown to html. First, you will need to add the lib into your build.gradle file:

dependencies {
    include 'com.enonic.lib:lib-markdown:<version>'
}

You can then use this inside your javascript controller or other parts of your app. Here's an example of using it inside a controller:

// Include the library
var markdown = require('/lib/markdown');

// Render markdown
exports.get = function(req) {

    // Render markdown to html
    var result = markdown.render('Hello *World*!');
    
    // Return the result as html
    return {
        status: 200,
        body: result,
        contentType: 'text/html'
    };
    
};