ember-showdown

This addon provides a component that transforms Markdown into valid HTML.

It is a fork of ember-cli-showdown, updated to use modern Ember features and to be deprecation-free.

• Fastboot compatible

Requirements

• ember-cli >= 3.27.0 (it may work with older versions but this hasn't been tested)

Usage

From within your Ember application, run the following:

• ember install ember-showdown

Passing a markdown string inline:

<MarkdownToHtml @markdown="#Markdown is cool [link](http://emberjs.com)" />

<!-- Output -->
<h1>Markdown is cool <a href="http://emberjs.com">link</a></h1>

You can also pass a bound value:

<MarkdownToHtml @markdown={{@postContent}} />

Showdown Options

You can use configuration settings from Showdown via the @showdownOptions argument:

<MarkdownToHtml
  @markdown={{@postContent}}
  @showdownOptions={{hash
    strikethrough=true
    literalMidWordUnderscores=true
    simplifiedAutoLink=true
  }}
/>

Global Showdown Options

Global options let you define options that will be used for all conversions, without having to include them in @showdownOptions each time. (@showdownOptions can be used to override global options.)

An example where you always want to auto link:

// config/environment.js
module.exports = function(environment) {
  let ENV = {
    showdown: {
      simplifiedAutoLink: true
    }
  }

  return ENV;
}

Showdown Extensions

You can load Showdown Extensions by specifying the "extensions" property when initializing your component:

<MarkdownToHtml
  @markdown={{@postContent}}
  @extensions={{this.myExtensionList}}
/>

<MarkdownToHtml
  @markdown={{@postContent}}
  @extensions="foo bar baz"
/>

(the extension list can be an array of strings or a space separated string)

Note that you'll have to register your extensions with Showdown first. For example, in an initializer:

// app/initializers/register-showdown-extensions.js
import showdown from 'showdown';

export function initialize() {
  showdown.extension('myExtensionName', function() {
    return [{
      type: 'html',
      regex: '<blockquote>',
      replace: '<blockquote class="blockquote">'
    }];
  });
}

export default {
  name: 'register-showdown-extensions',
  initialize
};

Dependencies

• Showdown

Development

• git clone https://github.com/pgengler/ember-showdown.git
• cd ember-showdown
• yarn install

Previewing

• ember serve
• Visit your app at http://localhost:4200.

Running tests

• ember test
• ember test --server

Building

• ember build