Class: HTML::Pipeline::MarkdownFilter

Inherits:
TextFilter show all
Defined in:
lib/html/pipeline/markdown_filter.rb

Overview

HTML Filter that converts Markdown text into HTML and converts into a DocumentFragment. This is different from most filters in that it can take a non-HTML as input. It must be used as the first filter in a pipeline.

Context options:

:gfm      => false    Disable GFM line-end processing
:commonmarker_extensions => [ :table, :strikethrough,
   :tagfilter, :autolink ] Common marker extensions to include

This filter does not write any additional information to the context hash.

Instance Attribute Summary

Attributes inherited from TextFilter

#text

Attributes inherited from Filter

#context, #result

Instance Method Summary collapse

Methods inherited from Filter

#base_url, call, #current_user, #doc, #has_ancestor?, #html, #needs, #parse_html, #repository, to_document, to_html, #validate

Constructor Details

#initialize(text, context = nil, result = nil) ⇒ MarkdownFilter


18
19
20
21
# File 'lib/html/pipeline/markdown_filter.rb', line 18

def initialize(text, context = nil, result = nil)
  super text, context, result
  @text = @text.delete "\r"
end

Instance Method Details

#callObject

Convert Markdown to HTML using the best available implementation and convert into a DocumentFragment.


25
26
27
28
29
30
31
32
33
34
35
36
# File 'lib/html/pipeline/markdown_filter.rb', line 25

def call
  options = [:GITHUB_PRE_LANG]
  options << :HARDBREAKS if context[:gfm] != false
  options << :UNSAFE if context[:unsafe]
  extensions = context.fetch(
    :commonmarker_extensions,
    %i[table strikethrough tagfilter autolink]
  )
  html = CommonMarker.render_html(@text, options, extensions)
  html.rstrip!
  html
end