kramdown-asciidoc 1.0.0.alpha.1 → 1.0.0.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70b7c1c3b371ac7e88456a531413b89ccb7186f706f44ad33abedd96ce6ef52d
-  data.tar.gz: b8ee1cb2365ff90ad26abb4528dad929cb75034297bd2e590c48453c2a3f61bc
+  metadata.gz: d272b7da83b441ebdb647887c7d9355fb05eba02b5dd3f01094bc7b089fe2a34
+  data.tar.gz: 58f6c5b345bd05e72c06a571b72cdd829766a87a33fa87b3ae0f0d7adab3b3b7
 SHA512:
-  metadata.gz: b2cf8e0cf5ef344ee31621f1b05e86e9504c5392adbc79b443db9594764bf51d39371cb2db57a36d7bb59ed4b0079a0eec0519c95d78cfb615c4cf00d8680830
-  data.tar.gz: 1bc00c04fd46be08e697a562eeea7f583a0e6afc3949a9c1bc937f1509d0605c07b367dec9fc2c578a8ff31f4d438349c5832b72799612f18b53eb9306549ce6
+  metadata.gz: e3f41c1b6a204e64ea4f4baf582910a0b06004dd1fe11676f6b2cb47cca317214c359a86991ba24c133aa18764df6ab1a4b06e9e107eeb31f0085d37d30e3719
+  data.tar.gz: 362e0cb506477aae3cf22b57b2be596b573259e6da83e20a0a9cfc62e0c7e63d830760975b2ddd72f360ffb59b07e0e0245dc779289153e17ef5c4af931fb5b7

data/CHANGELOG.adoc

@@ -5,6 +5,39 @@
 This document provides a high-level view of the changes to {project-name} by release.
 For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
 
+== 1.0.0.alpha.2 (2018-05-24) - @mojavelinux
+
+=== Added
+
+* automatically coerce level 5 heading above codeblock to block title
+* convert HTML-based admonition blocks
+* drop HTML div element if enclosing an image
+* transfer id and class/role attributes to block image
+* pass through width attribute to image if specified on HTML img element
+
+=== Changed
+
+* don't modify AST when converting
+* transfer comments above document title to document header
+* only process link as image with link if only child
+* escape closing square bracket in contents of link
+* don't add cols attribute to table if table only has a single column
+* don't add blank line between rows if table only has a single column
+* expand \| to |
+* escape pipe in table cell
+* replace ^ with \{caret} in normal text
+* replace double underscore in URL with %5F%5F
+* don't rewrite bash source language as console
+
+=== Details
+
+{uri-repo}/releases/tag/v1.0.0.alpha.2[git tag] |
+{uri-repo}/compare/v1.0.0.alpha.1...v1.0.0.alpha.2[full diff]
+
 == 1.0.0.alpha.1 (2018-05-22) - @mojavelinux
 
 Initial release.
+
+=== Details
+
+{uri-repo}/releases/tag/v1.0.0.alpha.1[git tag]

data/README.adoc

@@ -1,6 +1,6 @@
 = {project-name} (Markdown to AsciiDoc)
 Dan Allen <https://github.com/mojavelinux>
-v1.0.0.alpha.1, 2018-05-22
+v1.0.0.alpha.2, 2018-05-24
 // Aliases:
 :project-name: Kramdown AsciiDoc
 :project-handle: kramdown-asciidoc

data/lib/kramdown-asciidoc/converter.rb

@@ -27,7 +27,7 @@ module Kramdown; module AsciiDoc
       while (line = lines.shift) && line.chomp != '---'
         front_matter << line
       end
-      lines.shift while (line = lines[0]) && line.chomp.empty?
+      lines.shift while (line = lines[0]) && line == ?\n
       (::YAML.load front_matter.join).each do |key, val|
         case key
         when 'title'
@@ -45,7 +45,7 @@ module Kramdown; module AsciiDoc
   end
 
   class Converter < ::Kramdown::Converter::Base
-    RESOLVE_ENTITY_TABLE = %w(lt gt).map {|name| Utils::Entities.entity name }.map {|obj| [obj, obj.char] }.to_h
+    RESOLVE_ENTITY_TABLE = { 60 => '<', 62 => '>', 124 => '|' }
     ADMON_LABELS = %w(Note Tip Caution Warning Important Attention).map {|l| [l, l] }.to_h
     ADMON_MARKERS = ADMON_LABELS.map {|l, _| %(#{l}: ) }
     ADMON_FORMATTED_MARKERS = ADMON_LABELS.map {|l, _| [%(#{l}:), l] }.to_h
@@ -98,6 +98,7 @@ module Kramdown; module AsciiDoc
     end
 
     def convert_root el, opts
+      el = extract_prologue el, opts
       body = %(#{inner el, (opts.merge rstrip: true)}#{LF})
       @attributes.each {|k, v| @header << %(:#{k}: #{v}) } unless @attributes.empty?
       @header.empty? ? body : %(#{@header.join LF}#{body == LF ? '' : LFx2}#{body})
@@ -111,12 +112,19 @@ module Kramdown; module AsciiDoc
       result = []
       style = []
       level = el.options[:level]
-      style << 'discrete' if (discrete = @last_heading_level && level > @last_heading_level + 1)
+      if (discrete = @last_heading_level && level > @last_heading_level + 1)
+        # TODO make block title promotion an option (allow certain levels and titles)
+        #if ((raw_text = el.options[:raw_text]) == 'Example' || raw_text == 'Examples') &&
+        if level == 5 && (next_2_siblings = (siblings = opts[:parent].children).slice (siblings.index el) + 1, 2) &&
+            next_2_siblings.any? {|sibling| sibling.type == :codeblock }
+          return %(.#{inner el, opts}#{LF})
+        end
+        style << 'discrete'
+      end
       if (id = el.attr['id'])
         style << %(##{id})
       elsif (child_i = el.children[0] || VoidElement).type == :html_element && child_i.value == 'a' && (id = child_i.attr['id'])
-        el.children.shift
-        el.children.unshift(*child_i.children) unless child_i.children.empty?
+        el = clone el, children: child_i.children + (el.children.drop 1)
         style << %(##{id})
       elsif (role = el.attr['class'])
         style << %(.#{role.tr ' ', '.'})
@@ -125,7 +133,7 @@ module Kramdown; module AsciiDoc
       result << %(#{'=' * level} #{inner el, opts})
       @last_heading_level = level unless discrete
       if level == 1 && opts[:result].empty?
-        @header = result
+        @header += result
         nil
       else
         @attributes['doctype'] = 'book' if level == 1
@@ -149,15 +157,16 @@ module Kramdown; module AsciiDoc
       # NOTE detect plain admonition marker (e.g, Note: ...)
       if (child_i = el.children[0] || VoidElement).type == :text && (child_i_text = child_i.value).start_with?(*ADMON_MARKERS)
         marker, child_i_text = child_i_text.split ': ', 2
-        child_i.value = %(#{ADMON_TYPE_MAP[marker]}: #{child_i_text})
+        child_i = clone child_i, value: %(#{ADMON_TYPE_MAP[marker]}: #{child_i_text})
+        el = clone el, children: [child_i] + (el.children.drop 1)
         contents = inner el, opts
       # NOTE detect formatted admonition marker (e.g., *Note:* ...)
       elsif (child_i.type == :strong || child_i.type == :em) &&
           (marker_el = child_i.children[0]) && ((marker = ADMON_FORMATTED_MARKERS[marker_el.value]) ||
           ((marker = ADMON_LABELS[marker_el.value]) && (child_ii = el.children[1] || VoidElement).type == :text &&
           ((child_ii_text = child_ii.value).start_with? ': ')))
-        el.children.shift
-        child_ii.value = child_ii_text.slice 1, child_ii_text.length if child_ii
+        el = clone el, children: (el.children.drop 1)
+        el.children[0] = clone child_ii, value: (child_ii_text.slice 1, child_ii_text.length) if child_ii
         contents = %(#{ADMON_TYPE_MAP[marker]}:#{inner el, opts})
       else
         contents = inner el, opts
@@ -198,11 +207,11 @@ module Kramdown; module AsciiDoc
       contents = el.value.rstrip
       if (lang = el.attr['class'])
         lang = lang.slice 9, lang.length if lang.start_with? 'language-'
-        #lang = 'console' if lang == 'bash' && (contents.start_with? '$ ')
-        lang = 'console' if lang == 'bash'
+        # TODO remap lang if requested
         result << %([source,#{lang}])
       end
       if !lang && (contents.start_with? '$ ')
+        # QUESTION should we make these a source,console block?
         if contents.include? LFx2
           result << '....'
           result << contents
@@ -252,18 +261,22 @@ module Kramdown; module AsciiDoc
         container.children.each do |row|
           row_buf = []
           row.children.each do |cell|
-            row_buf << %(| #{inner cell, opts})
+            cell_contents = inner cell, opts
+            cell_contents = cell_contents.gsub '|', '\|' if cell_contents.include? '|'
+            row_buf << %(| #{cell_contents})
           end
-          cols = row_buf.size unless cols
+          cols ||= row_buf.size
           if container.type == :thead
             head = true
             row_buf = [row_buf * ' ']
+            row_buf << ''
+          elsif cols > 1
+            row_buf << ''
           end
-          row_buf << ''
           table_buf.concat row_buf
         end
       end
-      table_buf.unshift %([cols=#{cols}*]) unless head
+      table_buf.unshift %([cols=#{cols}*]) unless head || cols < 2
       table_buf.pop if table_buf[-1] == ''
       table_buf << '|==='
       %(#{table_buf * LF}#{LFx2})
@@ -274,15 +287,16 @@ module Kramdown; module AsciiDoc
     end
 
     def convert_text el, opts
-      if (result = el.value).include? '++'
+      if (text = el.value).include? '++'
         @attributes['pp'] = '{plus}{plus}'
-        result = result.gsub '++', '{pp}'
+        text = text.gsub '++', '{pp}'
       end
-      result = result.gsub '<=', '\\<=' if result.include? '<='
-      if result.ascii_only?
-        result
+      text = text.gsub '^', '{caret}' if (text.include? '^') && text != '^'
+      text = text.gsub '<=', '\<=' if text.include? '<='
+      if text.ascii_only?
+        text
       else
-        (result.gsub ApostropheRx, ?').gsub TypographicSymbolRx, TYPOGRAPHIC_SYMBOL_TO_MARKUP
+        (text.gsub ApostropheRx, ?').gsub TypographicSymbolRx, TYPOGRAPHIC_SYMBOL_TO_MARKUP
       end
     end
 
@@ -316,34 +330,56 @@ module Kramdown; module AsciiDoc
     end
 
     def convert_entity el, opts
-      RESOLVE_ENTITY_TABLE[el.value] || el.options[:original]
+      RESOLVE_ENTITY_TABLE[el.value.code_point] || el.options[:original]
     end
 
     def convert_a el, opts
       if (url = el.attr['href']).start_with? '#'
         %(<<#{url.slice 1, url.length},#{inner el, opts}>>)
       elsif url.start_with? 'https://', 'http://'
-        if (child_i = el.children[0] || VoidElement).type == :img
+        if (children = el.children).size == 1 && (child_i = el.children[0]).type == :img
           convert_img child_i, parent: opts[:parent], index: 0, url: url
         else
-          ((contents = inner el, opts).chomp '/') == (url.chomp '/') ? url : %(#{url}[#{contents}])
+          bare = ((contents = inner el, opts).chomp '/') == (url.chomp '/')
+          url = url.gsub '__', '%5F%5F' if (url.include? '__')
+          bare ? url : %(#{url}[#{contents.gsub ']', '\]'}])
         end
       elsif url.end_with? '.md'
-        %(xref:#{url.slice 0, url.length - 3}.adoc[#{inner el, opts}])
+        %(xref:#{url.slice 0, url.length - 3}.adoc[#{(inner el, opts).gsub ']', '\]'}])
       else
-        %(link:#{url}[#{inner el, opts}])
+        %(link:#{url}[#{(inner el, opts).gsub ']', '\]'}])
       end
     end 
 
     def convert_img el, opts
-      prefix = !(parent = opts[:parent]) || parent.type == :p && parent.children.size == 1 ? 'image::' : 'image:'
-      alt_text = el.attr['alt']
-      link_attr = (url = opts[:url]) ? %(#{alt_text.empty? ? '' : ','}link=#{url}) : ''
+      if !(parent = opts[:parent]) || parent.type == :p && parent.children.size == 1
+        style = []
+        if (id = el.attr['id'])
+          style << %(##{id})
+        end
+        if (role = el.attr['class'])
+          style << %(.#{role.tr ' ', '.'})
+        end
+        macro_prefix = style.empty? ? 'image::' : ([%([#{style.join}]), 'image::'].join LF)
+      else
+        macro_prefix = 'image:'
+      end
+      macro_attrs = []
+      if (alt_text = el.attr['alt'])
+        macro_attrs << alt_text unless alt_text.empty?
+      end
+      if (width = el.attr['width'])
+        macro_attrs << '' if macro_attrs.empty?
+        macro_attrs << width
+      end
+      if (url = opts[:url])
+        macro_attrs << %(link=#{url})
+      end
       src = el.attr['src']
       if (imagesdir = @imagesdir) && (src.start_with? %(#{imagesdir}/))
         src = src.slice imagesdir.length + 1, src.length
       end
-      %(#{prefix}#{src}[#{alt_text}#{link_attr}])
+      %(#{macro_prefix}#{src}[#{macro_attrs.join ','}])
     end
 
     # NOTE leave enabled so we can down-convert mdash to --
@@ -352,9 +388,20 @@ module Kramdown; module AsciiDoc
     end
 
     def convert_html_element el, opts
+      if (tagname = el.value) == 'div' && (child_i = el.children[0]) && child_i.options[:transparent] &&
+          (child_i_i = child_i.children[0])
+        if child_i_i.type == :img
+          return convert_img child_i_i, (opts.merge parent: child_i, index: 0) if child_i.children.size == 1
+        elsif child_i_i.value == 'span' && ((role = el.attr['class'] || '').start_with? 'note') &&
+            child_i_i.attr['class'] == 'notetitle'
+          marker = ADMON_FORMATTED_MARKERS[(child_i_i.children[0] || VoidElement).value] || 'Note'
+          (el = child_i.dup).children = el.children.drop 1
+          return %(#{ADMON_TYPE_MAP[marker]}:#{inner el, opts}#{LFx2})
+        end
+      end
       contents = inner el, (opts.merge rstrip: el.options[:category] == :block)
       attrs = (attrs = el.attr).empty? ? '' : attrs.map {|k, v| %( #{k}="#{v}") }.join
-      case (tagname = el.value)
+      case tagname
       when 'sup'
         %(^#{contents}^)
       when 'sub'
@@ -397,7 +444,16 @@ module Kramdown; module AsciiDoc
       end
     end
 
-    def inner el, opts
+    def extract_prologue el, opts
+      if (child_i = (children = el.children)[0] || VoidElement).type == :xml_comment
+        (prologue_el = el.dup).children = children.take_while {|child| child.type == :xml_comment || child.type == :blank }
+        (el = el.dup).children = children.drop prologue_el.children.size
+        @header += [%(#{inner prologue_el, (opts.merge rstrip: true)})]
+      end
+      el
+    end
+
+    def inner el, opts = {}
       rstrip = opts.delete :rstrip
       result = []
       prev = nil
@@ -407,6 +463,14 @@ module Kramdown; module AsciiDoc
       end
       rstrip ? result.join.rstrip : result.join
     end
+
+    def clone el, properties = {}
+      el = el.dup
+      properties.each do |name, value|
+        el.send %(#{name}=).to_sym, value
+      end
+      el
+    end
   end
 end; end
 

data/lib/kramdown-asciidoc/version.rb

@@ -1,3 +1,3 @@
 module Kramdown; module AsciiDoc
-  VERSION = '1.0.0.alpha.1'
+  VERSION = '1.0.0.alpha.2'
 end; end

data/spec/converter_spec.rb

@@ -4,16 +4,39 @@ describe Kramdown::AsciiDoc::Converter do
   let(:opts) { Kramdown::AsciiDoc::DEFAULT_PARSER_OPTS }
   let(:doc) { Kramdown::Document.new input, opts }
   let(:root) { doc.root }
+  let(:converter) { described_class.send :new, root, {} }
 
   context '#convert' do
     let (:input) { %(# Document Title\n\nBody text.) }
     it 'adds line feed (EOL) to end of output document' do
-      converter = described_class.send :new, root, {}
       (expect converter.convert root).to end_with %(\n)
       (expect doc.to_asciidoc).to end_with %(\n)
     end
   end
 
+  context '#clone' do
+    let :input do
+      <<~EOS
+      ## <a id="anchor-name">Heading Title</a>
+
+      Note: Be mindful.
+
+      *Important*: Turn off the lights.
+      EOS
+    end
+
+    it 'does not modify the AST when converting' do
+      doc.to_asciidoc
+      heading = root.children[0]
+      (expect heading.children[0].type).to be :html_element
+      (expect heading.children[0].value).to eql 'a'
+      para_i = root.children[2]
+      (expect para_i.children[0].value).to start_with 'Note: '
+      para_ii = root.children[4]
+      (expect para_ii.children[0].type).to be :em
+    end
+  end
+
   context '.replace_toc' do
     it 'does not modify source if TOC directive not detected' do
       input = <<~EOS

data/spec/fixtures/a/containing-inline-image.adoc

@@ -0,0 +1,5 @@
+https://rubygems.org/gems/kramdown-asciidoc[image:download.svg[\] Download]
+
+xref:download.adoc[image:download.svg[\] Download]
+
+link:download.html[image:download.svg[\] Download]

data/spec/fixtures/a/containing-inline-image.md

@@ -0,0 +1,5 @@
+[![](download.svg) Download](https://rubygems.org/gems/kramdown-asciidoc)
+
+[![](download.svg) Download](download.md)
+
+[![](download.svg) Download](download.html)

data/spec/fixtures/a/double-underscore-in-url.adoc

@@ -0,0 +1 @@
+See the https://example.com/compatibility.html#feature-matrix%5F%5Fproduct_a[compatibility feature matrix for product A].

data/spec/fixtures/a/double-underscore-in-url.md

@@ -0,0 +1 @@
+See the [compatibility feature matrix for product A](https://example.com/compatibility.html#feature-matrix__product_a).

data/spec/fixtures/codespan/literal.adoc

@@ -1,3 +1,5 @@
 Use the `+<=+` operator to define a version that is less than or equal to a specific version.
 
 Use `+(start...end)+` to create a range from start to end that excludes the last element.
+
+Use an `+<!-- XML comment -->+` to disable or hide markup.

data/spec/fixtures/codespan/literal.md

@@ -1,3 +1,5 @@
 Use the `<=` operator to define a version that is less than or equal to a specific version.
 
 Use `(start...end)` to create a range from start to end that excludes the last element.
+
+Use an `<!-- XML comment -->` to disable or hide markup.

data/spec/fixtures/entity/reverse.adoc

@@ -1 +1,3 @@
 <undefined>
+
+a | b

data/spec/fixtures/entity/reverse.md

@@ -1 +1,3 @@
 <undefined>
+
+a | b

data/spec/fixtures/heading/block-title.adoc

@@ -0,0 +1,10 @@
+= Document Title
+
+What follows is a listing with a block title.
+
+.Example
+----
+SELECT * from users u where u.id = 1;
+----
+
+This query should return exactly one result.

data/spec/fixtures/heading/block-title.md

@@ -0,0 +1,9 @@
+# Document Title
+
+What follows is a listing with a block title.
+
+##### Example
+
+    SELECT * from users u where u.id = 1;
+
+This query should return exactly one result.

data/spec/fixtures/heading/not-block-title.adoc

@@ -0,0 +1,8 @@
+= Document Title
+
+Paragraph
+
+[discrete]
+===== Discrete Heading
+
+Paragraph

data/spec/fixtures/heading/not-block-title.md

@@ -0,0 +1,7 @@
+# Document Title
+
+Paragraph
+
+##### Discrete Heading
+
+Paragraph

data/spec/fixtures/html_element/admonition.adoc

@@ -0,0 +1,5 @@
+Main instructions.
+
+IMPORTANT: For the configuration changes to take effect, the server must be restarted using the link:restart-api.html[Restart API].
+
+Now back to our regularly scheduled program.

data/spec/fixtures/html_element/admonition.md

@@ -0,0 +1,7 @@
+Main instructions.
+
+<div class="note note"><span class="notetitle">Attention:</span> For the configuration changes to take effect,
+the server must be restarted using the <a href="restart-api.html">Restart API</a>.
+</div>
+
+Now back to our regularly scheduled program.

data/spec/fixtures/html_element/img-with-alt-and-width.adoc

@@ -0,0 +1 @@
+image::logo.png[Project,480]

data/spec/fixtures/html_element/img-with-alt-and-width.md

@@ -0,0 +1 @@
+<img src="logo.png" alt="Project" width="480">

data/spec/fixtures/html_element/img-with-width.adoc

@@ -0,0 +1 @@
+image::logo.png[,480]

data/spec/fixtures/html_element/img-with-width.md

@@ -0,0 +1 @@
+<img src="logo.png" width="480">

data/spec/fixtures/html_element/img.adoc

@@ -0,0 +1,2 @@
+[#img-add-new-user.image]
+image::add-new-user.png[Add New User]

data/spec/fixtures/html_element/img.md

@@ -0,0 +1 @@
+<div><img id="img-add-new-user" class="image" src="add-new-user.png" alt="Add New User"/></div>

data/spec/fixtures/table/cell-with-pipe.adoc

@@ -0,0 +1,5 @@
+[cols=2*]
+|===
+| a\|b
+| c\|d
+|===

data/spec/fixtures/table/cell-with-pipe.md

@@ -0,0 +1 @@
+| a\|b | c\|d |

data/spec/fixtures/table/single-column-with-header.adoc

@@ -0,0 +1,6 @@
+|===
+| col
+
+| abc
+| xyz
+|===

data/spec/fixtures/table/single-column-with-header.md

@@ -0,0 +1,4 @@
+| col |
+| --- |
+| abc |
+| xyz |

data/spec/fixtures/table/single-column-without-header.adoc

@@ -0,0 +1,4 @@
+|===
+| abc
+| xyz
+|===

data/spec/fixtures/table/single-column-without-header.md

@@ -0,0 +1,2 @@
+| abc |
+| xyz |

data/spec/fixtures/text/caret.adoc

@@ -0,0 +1 @@
+Current mood: {caret}_{caret}

data/spec/fixtures/text/caret.md

@@ -0,0 +1 @@
+Current mood: ^_^

data/spec/fixtures/xml_comment/above-header.adoc

@@ -0,0 +1,13 @@
+// Copyright 2018 ACME, Inc.
+
+////
+Usage:
+
+* Download
+* Install
+* Deploy
+* Prevail
+////
+= Command Line Tool
+
+You can use the command line tool to trap roadrunners from your office chair.

data/spec/fixtures/xml_comment/above-header.md

@@ -0,0 +1,16 @@
+<!--
+Copyright 2018 ACME, Inc.
+-->
+
+<!--
+Usage:
+
+* Download
+* Install
+* Deploy
+* Prevail
+-->
+
+# Command Line Tool
+
+You can use the command line tool to trap roadrunners from your office chair.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kramdown-asciidoc
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha.1
+  version: 1.0.0.alpha.2
 platform: ruby
 authors:
 - Dan Allen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-22 00:00:00.000000000 Z
+date: 2018-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: kramdown
@@ -87,6 +87,10 @@ files:
 - spec/converter_spec.rb
 - spec/fixtures/a/bare-url.adoc
 - spec/fixtures/a/bare-url.md
+- spec/fixtures/a/containing-inline-image.adoc
+- spec/fixtures/a/containing-inline-image.md
+- spec/fixtures/a/double-underscore-in-url.adoc
+- spec/fixtures/a/double-underscore-in-url.md
 - spec/fixtures/a/interdoc-xref.adoc
 - spec/fixtures/a/interdoc-xref.md
 - spec/fixtures/a/internal.adoc
@@ -117,8 +121,6 @@ files:
 - spec/fixtures/br/trailing-double-space.md
 - spec/fixtures/codeblock/contiguous-lines.adoc
 - spec/fixtures/codeblock/contiguous-lines.md
-- spec/fixtures/codeblock/fenced/bash-to-console.adoc
-- spec/fixtures/codeblock/fenced/bash-to-console.md
 - spec/fixtures/codeblock/fenced/with-command-prompt.adoc
 - spec/fixtures/codeblock/fenced/with-command-prompt.md
 - spec/fixtures/codeblock/fenced/with-language.adoc
@@ -145,6 +147,10 @@ files:
 - spec/fixtures/entity/numeric.md
 - spec/fixtures/entity/reverse.adoc
 - spec/fixtures/entity/reverse.md
+- spec/fixtures/heading/block-title.adoc
+- spec/fixtures/heading/block-title.md
+- spec/fixtures/heading/not-block-title.adoc
+- spec/fixtures/heading/not-block-title.md
 - spec/fixtures/heading/out-of-sequence.adoc
 - spec/fixtures/heading/out-of-sequence.md
 - spec/fixtures/heading/outline.adoc
@@ -159,10 +165,18 @@ files:
 - spec/fixtures/hr/dashes.md
 - spec/fixtures/html_element/abbr.adoc
 - spec/fixtures/html_element/abbr.md
+- spec/fixtures/html_element/admonition.adoc
+- spec/fixtures/html_element/admonition.md
 - spec/fixtures/html_element/heading-with-class.adoc
 - spec/fixtures/html_element/heading-with-class.md
 - spec/fixtures/html_element/heading-with-id.adoc
 - spec/fixtures/html_element/heading-with-id.md
+- spec/fixtures/html_element/img-with-alt-and-width.adoc
+- spec/fixtures/html_element/img-with-alt-and-width.md
+- spec/fixtures/html_element/img-with-width.adoc
+- spec/fixtures/html_element/img-with-width.md
+- spec/fixtures/html_element/img.adoc
+- spec/fixtures/html_element/img.md
 - spec/fixtures/html_element/native.adoc
 - spec/fixtures/html_element/native.md
 - spec/fixtures/html_element/sub.adoc
@@ -239,10 +253,18 @@ files:
 - spec/fixtures/strong/constrained.md
 - spec/fixtures/strong/nested-emphasis.adoc
 - spec/fixtures/strong/nested-emphasis.md
+- spec/fixtures/table/cell-with-pipe.adoc
+- spec/fixtures/table/cell-with-pipe.md
+- spec/fixtures/table/single-column-with-header.adoc
+- spec/fixtures/table/single-column-with-header.md
+- spec/fixtures/table/single-column-without-header.adoc
+- spec/fixtures/table/single-column-without-header.md
 - spec/fixtures/table/with-header.adoc
 - spec/fixtures/table/with-header.md
 - spec/fixtures/table/without-header.adoc
 - spec/fixtures/table/without-header.md
+- spec/fixtures/text/caret.adoc
+- spec/fixtures/text/caret.md
 - spec/fixtures/text/lte.adoc
 - spec/fixtures/text/lte.md
 - spec/fixtures/text/plus-plus.adoc
@@ -277,6 +299,8 @@ files:
 - spec/fixtures/ul/simple-separated.md
 - spec/fixtures/ul/simple.adoc
 - spec/fixtures/ul/simple.md
+- spec/fixtures/xml_comment/above-header.adoc
+- spec/fixtures/xml_comment/above-header.md
 - spec/fixtures/xml_comment/block.adoc
 - spec/fixtures/xml_comment/block.md
 - spec/fixtures/xml_comment/line-offset-by-space.adoc
@@ -325,6 +349,10 @@ test_files:
 - spec/converter_spec.rb
 - spec/fixtures/a/bare-url.adoc
 - spec/fixtures/a/bare-url.md
+- spec/fixtures/a/containing-inline-image.adoc
+- spec/fixtures/a/containing-inline-image.md
+- spec/fixtures/a/double-underscore-in-url.adoc
+- spec/fixtures/a/double-underscore-in-url.md
 - spec/fixtures/a/interdoc-xref.adoc
 - spec/fixtures/a/interdoc-xref.md
 - spec/fixtures/a/internal.adoc
@@ -355,8 +383,6 @@ test_files:
 - spec/fixtures/br/trailing-double-space.md
 - spec/fixtures/codeblock/contiguous-lines.adoc
 - spec/fixtures/codeblock/contiguous-lines.md
-- spec/fixtures/codeblock/fenced/bash-to-console.adoc
-- spec/fixtures/codeblock/fenced/bash-to-console.md
 - spec/fixtures/codeblock/fenced/with-command-prompt.adoc
 - spec/fixtures/codeblock/fenced/with-command-prompt.md
 - spec/fixtures/codeblock/fenced/with-language.adoc
@@ -383,6 +409,10 @@ test_files:
 - spec/fixtures/entity/numeric.md
 - spec/fixtures/entity/reverse.adoc
 - spec/fixtures/entity/reverse.md
+- spec/fixtures/heading/block-title.adoc
+- spec/fixtures/heading/block-title.md
+- spec/fixtures/heading/not-block-title.adoc
+- spec/fixtures/heading/not-block-title.md
 - spec/fixtures/heading/out-of-sequence.adoc
 - spec/fixtures/heading/out-of-sequence.md
 - spec/fixtures/heading/outline.adoc
@@ -397,10 +427,18 @@ test_files:
 - spec/fixtures/hr/dashes.md
 - spec/fixtures/html_element/abbr.adoc
 - spec/fixtures/html_element/abbr.md
+- spec/fixtures/html_element/admonition.adoc
+- spec/fixtures/html_element/admonition.md
 - spec/fixtures/html_element/heading-with-class.adoc
 - spec/fixtures/html_element/heading-with-class.md
 - spec/fixtures/html_element/heading-with-id.adoc
 - spec/fixtures/html_element/heading-with-id.md
+- spec/fixtures/html_element/img-with-alt-and-width.adoc
+- spec/fixtures/html_element/img-with-alt-and-width.md
+- spec/fixtures/html_element/img-with-width.adoc
+- spec/fixtures/html_element/img-with-width.md
+- spec/fixtures/html_element/img.adoc
+- spec/fixtures/html_element/img.md
 - spec/fixtures/html_element/native.adoc
 - spec/fixtures/html_element/native.md
 - spec/fixtures/html_element/sub.adoc
@@ -477,10 +515,18 @@ test_files:
 - spec/fixtures/strong/constrained.md
 - spec/fixtures/strong/nested-emphasis.adoc
 - spec/fixtures/strong/nested-emphasis.md
+- spec/fixtures/table/cell-with-pipe.adoc
+- spec/fixtures/table/cell-with-pipe.md
+- spec/fixtures/table/single-column-with-header.adoc
+- spec/fixtures/table/single-column-with-header.md
+- spec/fixtures/table/single-column-without-header.adoc
+- spec/fixtures/table/single-column-without-header.md
 - spec/fixtures/table/with-header.adoc
 - spec/fixtures/table/with-header.md
 - spec/fixtures/table/without-header.adoc
 - spec/fixtures/table/without-header.md
+- spec/fixtures/text/caret.adoc
+- spec/fixtures/text/caret.md
 - spec/fixtures/text/lte.adoc
 - spec/fixtures/text/lte.md
 - spec/fixtures/text/plus-plus.adoc
@@ -515,6 +561,8 @@ test_files:
 - spec/fixtures/ul/simple-separated.md
 - spec/fixtures/ul/simple.adoc
 - spec/fixtures/ul/simple.md
+- spec/fixtures/xml_comment/above-header.adoc
+- spec/fixtures/xml_comment/above-header.md
 - spec/fixtures/xml_comment/block.adoc
 - spec/fixtures/xml_comment/block.md
 - spec/fixtures/xml_comment/line-offset-by-space.adoc

data/spec/fixtures/codeblock/fenced/bash-to-console.adoc

@@ -1,4 +0,0 @@
-[source,console]
-----
-$ docker -it --run node:8-alpine
-----

data/spec/fixtures/codeblock/fenced/bash-to-console.md

@@ -1,3 +0,0 @@
-```bash
-$ docker -it --run node:8-alpine
-```