Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including maren-core with all npm packages installed. Try it out:

var marenCore = require("maren-core")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

maren-core v0.1.1

theme based markdown renderer

Maren Core

Maren is a theme based markdown renderer. It renders markdown to html by using a theme.

Theme can be developed by any tools. It is completely separated from Maren to allow easy and rich customization.

Install

npm install maren-core

API

const {
  render,
  loadTheme,
  basicTheme
} = require('maren-core');

render

/**
 * Render markdownString to html by using a theme.
 *
 * @param {string} markdownString - Markdown to render to html
 * @param {object} theme - Theme used to render Markdown
 * @param {object} theme.options
 * @param {array} theme.options.styles - Paths to css files
 * @param {array} theme.options.scripts - Paths to js files
 * @param {function} theme.beforeRender - Modify "data" to render
 * @param {function} theme.template - Template used to render html
 *
 * @return {string} Usually html, depends on template
 */
function render(markdownString, theme) { /* */ }

loadTheme

/**
 * Load theme from themeLocation.
 * Required file: themeLocation/template.js
 * Optional file: themeLocation/options.json
 *
 * @param {string} themeLocation - Absolute path to theme folder
 *
 * @return {object} Theme object { name, location, template, options }
 * @return {undefined} If theme not found
 */
function loadTheme(themeLocation) { /* */ }

basicTheme

console.log(basicTheme);
/*
{ name: 'basic',
  location: '.../maren-core/themes/basic',
  template: [Function],
  options: {} }
*/

Theme

const theme = {
  // required
  // should be compiled render function, but can be other
  template: data => data,

  // optional
  // can modify data in any way, don't forget to return new data
  beforeRender: data => {
    console.log(data);
    return data;
  },

  // optional
  // should contain minified and hashed styles and scripts
  options: {
    styles: ["styles-a8945f9ff83852c0da4d9b56dc0b50fd.css"],
    scripts: ["scripts-a73c5dd921d5f33f040f5f51890f04af.js"]
  },

  // if theme is not manually created, but loaded using loadTheme,
  // it will also have "name" and "location" like basicTheme
};

Use

Dummy theme

const { render } = require('maren-core');

/* your markdown string */
const markdown = '# Article';

/* your theme */
const theme = {
  /* required */
  template: (data) => {
    /* template can render data using
       template library of choice
       (pug, ejs, handlebars, mustache, or other)
       or simply return data as is */
    return data;
  },

  /* not required */
  options: undefined,
  beforeRender: undefined
};

/* output depends on the theme */
const output = render(markdown, theme);

console.log(output);
/*
{ meta: { title: 'Article', toc: undefined },
  html: '<h1 id="article">Article</h1>\n',
  options: undefined }
*/

Basic theme

const { render, basicTheme } = require('maren-core');

/* your markdown string */
const markdown = '# Article';

/* output depends on the theme */
const output = render(markdown, basicTheme);

console.log(output);
/*
<html>...</html>
*/

Tests

npm test

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free