kramdown-asciidoc 1.0.0.alpha.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 70b7c1c3b371ac7e88456a531413b89ccb7186f706f44ad33abedd96ce6ef52d
+  data.tar.gz: b8ee1cb2365ff90ad26abb4528dad929cb75034297bd2e590c48453c2a3f61bc
+SHA512:
+  metadata.gz: b2cf8e0cf5ef344ee31621f1b05e86e9504c5392adbc79b443db9594764bf51d39371cb2db57a36d7bb59ed4b0079a0eec0519c95d78cfb615c4cf00d8680830
+  data.tar.gz: 1bc00c04fd46be08e697a562eeea7f583a0e6afc3949a9c1bc937f1509d0605c07b367dec9fc2c578a8ff31f4d438349c5832b72799612f18b53eb9306549ce6

data/CHANGELOG.adoc

@@ -0,0 +1,10 @@
+= {project-name} Changelog
+:project-name: Kramdown AsciiDoc
+:uri-repo: https://github.com/asciidoctor/kramdown-asciidoc
+
+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.1 (2018-05-22) - @mojavelinux
+
+Initial release.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.adoc

@@ -0,0 +1,22 @@
+.The MIT License
+....
+Copyright (C) 2016 OpenDevise Inc. (on behalf of the Asciidoctor Project)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+....

data/README.adoc

@@ -0,0 +1,147 @@
+= {project-name} (Markdown to AsciiDoc)
+Dan Allen <https://github.com/mojavelinux>
+v1.0.0.alpha.1, 2018-05-22
+// Aliases:
+:project-name: Kramdown AsciiDoc
+:project-handle: kramdown-asciidoc
+// Settings:
+:idprefix:
+:idseparator: -
+ifndef::env-github[:icons: font]
+ifdef::env-github,env-browser[]
+:toc: preamble
+:toclevels: 1
+endif::[]
+ifdef::env-github[]
+:status:
+:!toc-title:
+:note-caption: :paperclip:
+:tip-caption: :bulb:
+endif::[]
+// URIs:
+:uri-repo: https://github.com/asciidoctor/kramdown-asciidoc
+:uri-asciidoc: https://asciidoctor.org/docs/what-is-asciidoc/#what-is-asciidoc
+:uri-asciidoctor: https://asciidoctor.org
+:uri-rvm: https://rvm.io
+:uri-install-rvm: https://rvm.io/rvm/install
+//:img-gem: https://img.shields.io/gem/v/kramdown-asciidoc.svg?label=gem
+:uri-ci-travis: https://travis-ci.org/asciidoctor/kramdown-asciidoc
+:img-ci-travis: https://img.shields.io/travis/asciidoctor/kramdown-asciidoc/master.svg
+
+ifdef::status[]
+//image:{img-gem}[Gem Version,link={uri-gem}]
+image:{img-ci-travis}[Build Status (Travis CI),link={uri-ci-travis}]
+endif::[]
+
+{uri-repo}[{project-name}] (gem: *{project-handle}*) is a Kramdown extension for converting Markdown documents to {uri-asciidoc}[AsciiDoc].
+Notably, the converter generates modern AsciiDoc syntax suitable for use with {uri-asciidoctor}[Asciidoctor].
+
+== Prerequisites
+
+To install and run {project-name}, you need Ruby 2.4 or better installed and a few RubyGems (aka gems).
+We'll explain how to install the gems in the next section.
+
+To check whether you have Ruby installed, and which version you have, run the following command:
+
+ $ ruby -v
+
+If Ruby is not installed, you can install it using {uri-rvm}[RVM] (or, if you prefer, the package manager for your system).
+We generally recommend using RVM because it allows you to install gems without requiring elevated privileges or messing with system libraries.
+
+== Installation
+
+{project-name} is published as a pre-release gem named {project-handle} to RubyGems.org.
+
+You can install the pre-release version using the following command:
+
+ $ gem install kramdown-asciidoc --pre
+
+Installing this gem makes the `kramdoc` command available on your $PATH.
+
+TIP: To test a feature that's not yet released, you can <<Development,run the application from source>>.
+
+== Usage
+
+To convert a Markdown file to AsciiDoc using {project-name}, run the `kramdoc` command as follows:
+
+ $ kramdoc sample.md
+
+The `kramdoc` command automatically creates the output file [.path]_sample.adoc_ in the same folder as the input file.
+This path is calculated by removing the Markdown file extension, `.md`, and adding the AsciiDoc file extension, `.adoc`.
+
+NOTE: The converter assumes the input uses the GitHub-flavor Markdown (GFM) syntax.
+
+The `kramdoc` command does not currently support any options other than the input file.
+Support for additional options is planned.
+
+== Development
+
+To help develop {project-name}, or to simply test-drive the development version, you need to retrieve the source from GitHub.
+Follow the instructions below to learn how to clone the source and run the application from source (i.e., your clone).
+
+=== Retrieve the source code
+
+Simply copy the {uri-repo}[GitHub repository URL] and pass it to the `git clone` command:
+
+[subs=attributes+]
+ $ git clone {uri-repo}
+
+Next, switch to the project directory:
+
+[subs=attributes+]
+ $ cd {project-handle}
+
+=== Prepare RVM (optional)
+
+We recommend using {uri-rvm}[RVM] when developing applications with Ruby.
+We like RVM because it keeps the dependencies required by the project isolated from the rest of your system.
+Follow the {uri-install-rvm}[installation instructions] on the RVM site to setup RVM and install Ruby.
+
+Once you have RVM setup, switch to the RVM-managed version of Ruby recommended by the project using this command:
+
+ $ rvm use
+
+The recommended version of Ruby is defined in the [.path]_.ruby-version_ file at the root of the project.
+
+=== Install the dependencies
+
+The dependencies needed to use {project-name} are defined in the [.path]_Gemfile_ at the root of the project.
+You'll use Bundler to install these dependencies.
+
+To check if you have Bundler available, use the `bundle` command to query the version installed:
+
+ $ bundle --version
+
+If Bundler is not installed, use the `gem` command to install it.
+
+ $ gem install bundler
+
+Then, use the `bundle` command to install the project dependencies under the project directory:
+
+ $ bundle --path=.bundle/gems
+
+NOTE: You must invoke `bundle` from the project's root directory so it can locate the [.path]_Gemfile_.
+
+=== Usage
+
+When running the `kramdoc` command from source, you must prefix the command with `bundle exec`:
+
+ $ bundle exec kramdoc sample.md
+
+To avoid having to do this, or make the `kramdoc` command available from anywhere, you need to build the development gem and install it.
+
+== Alternatives
+
+* https://github.com/bodiam/markdown-to-asciidoc[markdown-to-asciidoc] (Java library)
+* http://pandoc.org[pandoc] (Haskell-based CLI tool)
+
+== Authors
+
+*{project-name}* was written by {email}[{author}].
+
+== Copyright
+
+Copyright (C) 2016-2018 OpenDevise Inc. (on behalf of the Asciidoctor Project).
+Free use of this software is granted under the terms of the MIT License.
+
+See the link:LICENSE.adoc[LICENSE] file for details.

data/Rakefile

@@ -0,0 +1,3 @@
+Dir.glob('tasks/*.rake').each {|file| load file }
+
+task default: %w(spec)

data/bin/kramdoc

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+if File.exist? (kramdown_asciidoc = File.absolute_path '../lib/kramdown-asciidoc', __dir__)
+  require kramdown_asciidoc
+else
+  require 'kramdown-asciidoc'
+end
+
+infile = ARGV.first
+unless infile
+  warn 'Please specify a Markdown file to convert.'
+  exit 1
+end
+outfile = %(#{infile.slice 0, infile.length - (File.extname infile).length}.adoc)
+input = (IO.read infile, open_args: ['rb:UTF-8']).rstrip
+input = input.slice 1, input.length while input.start_with? ?\n
+attributes = {}
+input = Kramdown::AsciiDoc.extract_front_matter input, attributes
+input = Kramdown::AsciiDoc.replace_toc input, attributes
+# FIXME allow input type to be specified (Kramdown, GFM, etc)
+doc = Kramdown::Document.new input, (Kramdown::AsciiDoc::DEFAULT_PARSER_OPTS.merge attributes: attributes)
+# FIXME provide option to write to different file or stdout
+IO.write outfile, doc.to_asciidoc
+exit 0

data/kramdown-asciidoc.gemspec

@@ -0,0 +1,41 @@
+require File.absolute_path 'lib/kramdown-asciidoc/version', __dir__
+require 'open3' unless defined? Open3
+
+Gem::Specification.new do |s|
+  s.name = 'kramdown-asciidoc'
+  s.version = Kramdown::AsciiDoc::VERSION
+  s.summary = 'A Markdown to AsciiDoc converter based on Kramdown'
+  s.description = 'A Kramdown extension for converting Markdown documents to AsciiDoc.'
+
+  s.authors = ['Dan Allen']
+  s.email = ['dan.j.allen@gmail.com']
+  s.homepage = 'https://github.com/asciidoctor/kramdown-asciidoc'
+  s.license = 'MIT'
+  s.metadata = {
+    'bug_tracker_uri' => 'https://github.com/asciidoctor/kramdown-asciidoc/issues',
+    'changelog_uri' => 'https://github.com/asciidoctor/kramdown-asciidoc/blob/master/CHANGELOG.adoc',
+    'mailing_list_uri' => 'http://discuss.asciidoctor.org',
+    'source_code_uri' => 'https://github.com/asciidoctor/kramdown-asciidoc'
+  }
+  #s.required_ruby_version = '>= 2.4.0'
+
+  files = begin
+    (result = Open3.popen3('git ls-files -z') {|_, out| out.read }.split ?\0).empty? ? Dir['**/*'] : result
+  rescue
+    Dir['**/*']
+  end
+  s.files = files.grep %r/^(?:lib\/.+|Gemfile|Rakefile|(?:CHANGELOG|CONTRIBUTING|LICENSE|README)\.adoc|#{s.name}\.gemspec)$/
+  s.test_files = files.grep %r/^(?:spec\/.+)$/
+  s.executables = ['kramdoc']
+
+  s.require_paths = ['lib']
+
+  #s.has_rdoc = true
+  #s.rdoc_options = ['--charset=UTF-8']
+  #s.extra_rdoc_files = ['CHANGELOG.adoc', 'LICENSE.adoc']
+
+  s.add_runtime_dependency 'kramdown', '~> 1.16.2'
+  s.add_development_dependency 'rake', '~> 12.3.1'
+  s.add_development_dependency 'rspec', '~> 3.7.0'
+  s.add_development_dependency 'simplecov', '~> 0.16.1'
+end

data/lib/kramdown-asciidoc.rb

@@ -0,0 +1,2 @@
+require 'kramdown'
+require_relative 'kramdown-asciidoc/converter'

data/lib/kramdown-asciidoc/converter.rb

@@ -0,0 +1,413 @@
+# encoding: UTF-8
+module Kramdown; module AsciiDoc
+  DEFAULT_PARSER_OPTS = {
+    auto_ids: false,
+    hard_wrap: false,
+    html_to_native: true,
+    input: 'GFM',
+  }
+
+  TocDirectiveTip = '<!-- TOC '
+  TocDirectiveRx = /^<!-- TOC .*<!-- \/TOC -->/m
+
+  def self.replace_toc source, attributes
+    if source.include? TocDirectiveTip
+      attributes['toc'] = 'macro'
+      source.gsub TocDirectiveRx, 'toc::[]'
+    else
+      source
+    end
+  end
+
+  def self.extract_front_matter source, attributes
+    if (line_i = (lines = source.each_line).next) && line_i.chomp == '---'
+      require 'yaml' unless defined? ::YAML
+      lines = lines.drop 1
+      front_matter = []
+      while (line = lines.shift) && line.chomp != '---'
+        front_matter << line
+      end
+      lines.shift while (line = lines[0]) && line.chomp.empty?
+      (::YAML.load front_matter.join).each do |key, val|
+        case key
+        when 'title'
+          # skip
+        when 'layout'
+          attributes['page-layout'] = val unless val == 'default'
+        else
+          attributes[key] = val.to_s
+        end
+      end
+      lines.join
+    else
+      source
+    end
+  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
+    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
+    ADMON_TYPE_MAP = ADMON_LABELS.map {|l, _| [l, l.upcase] }.to_h.merge 'Attention' => 'IMPORTANT'
+    # FIXME here we reverse the smart quotes; add option to allow them (needs to be handled carefully)
+    SMART_QUOTE_ENTITY_TO_MARKUP = { ldquo: ?", rdquo: ?", lsquo: ?', rsquo: ?' }
+    TYPOGRAPHIC_SYMBOL_TO_MARKUP = {
+      '“' => '"`',
+      '”' => '`"',
+      '‘' => '\'`',
+      '’' => '`\'',
+      # FIXME in the future, mdash will be three dashes in AsciiDoc; for now, down-convert
+      '—' => '--',
+      '–' => '&#8211;',
+      '…' => '...',
+    }
+    TYPOGRAPHIC_ENTITY_TO_MARKUP = {
+      # FIXME in the future, mdash will be three dashes in AsciiDoc; for now, down-convert
+      mdash: '--',
+      ndash: '--',
+      hellip: '...',
+      laquo: '<<',
+      raquo: '>>',
+      laquo_scape: '<< ',
+      raquo_space: ' >>',
+    }
+
+    ApostropheRx = /\b’\b/
+    CommentPrefixRx = /^ *! ?/m
+    ReplaceableTextRx = /[-=]>|<[-=]|\.\.\./
+    StartOfLinesRx = /^/m
+    TypographicSymbolRx = /[“”‘’—–…]/
+    XmlCommentRx = /\A<!--(.*)-->\Z/m
+
+    VoidElement = Element.new nil
+
+    LF = ?\n
+    LFx2 = LF * 2
+
+    def initialize root, opts
+      super
+      @header = []
+      @attributes = opts[:attributes] || {}
+      @imagesdir = (@attributes.delete 'implicit-imagesdir') || @attributes['imagesdir']
+      @last_heading_level = nil
+    end
+
+    def convert el, opts = {}
+      send %(convert_#{el.type}), el, opts
+    end
+
+    def convert_root 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})
+    end
+
+    def convert_blank el, opts
+      nil
+    end
+
+    def convert_heading el, opts
+      result = []
+      style = []
+      level = el.options[:level]
+      style << 'discrete' if (discrete = @last_heading_level && level > @last_heading_level + 1)
+      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?
+        style << %(##{id})
+      elsif (role = el.attr['class'])
+        style << %(.#{role.tr ' ', '.'})
+      end
+      result << %([#{style.join}]) unless style.empty?
+      result << %(#{'=' * level} #{inner el, opts})
+      @last_heading_level = level unless discrete
+      if level == 1 && opts[:result].empty?
+        @header = result
+        nil
+      else
+        @attributes['doctype'] = 'book' if level == 1
+        %(#{result.join LF}#{LFx2})
+      end
+    end
+
+    # Kramdown incorrectly uses the term header for headings
+    alias convert_header convert_heading
+
+    def convert_p el, opts
+      if (parent = opts[:parent]) && parent.type == :li
+        # NOTE :prev option not set indicates primary text; convert_li appends LF
+        return inner el, opts unless opts[:prev]
+        parent.options[:compound] = true
+        opts[:result].pop unless opts[:result][-1]
+        prefix, suffix = %(#{LF}+#{LF}), ''
+      else
+        prefix, suffix = '', LFx2
+      end
+      # 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})
+        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
+        contents = %(#{ADMON_TYPE_MAP[marker]}:#{inner el, opts})
+      else
+        contents = inner el, opts
+      end
+      %(#{prefix}#{contents}#{suffix})
+    end
+
+    # TODO detect admonition masquerading as blockquote
+    def convert_blockquote el, opts
+      result = []
+      # TODO support more than one level of nesting
+      boundary = (parent = opts[:parent]) && parent.type == :blockquote ? '______' : '____'
+      contents = inner el, (opts.merge rstrip: true)
+      if (contents.include? LF) && ((attribution_line = (lines = contents.split LF).pop).start_with? '-- ')
+        attribution = attribution_line.slice 3, attribution_line.length
+        result << %([,#{attribution}])
+        lines.pop while lines.size > 0 && lines[-1].empty?
+        contents = lines.join LF
+      end
+      result << boundary
+      result << contents
+      result << boundary
+      %(#{result.join LF}#{LFx2})
+    end
+
+    def convert_codeblock el, opts
+      result = []
+      if (parent = opts[:parent]) && parent.type == :li
+        parent.options[:compound] = true
+        if (current_line = opts[:result].pop)
+          opts[:result] << current_line.chomp
+        end unless opts[:result].empty?
+        list_continuation = %(#{LF}+)
+        suffix = ''
+      else
+        suffix = LFx2
+      end
+      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'
+        result << %([source,#{lang}])
+      end
+      if !lang && (contents.start_with? '$ ')
+        if contents.include? LFx2
+          result << '....'
+          result << contents
+          result << '....'
+        else
+          list_continuation = LF if list_continuation
+          result << (contents.gsub StartOfLinesRx, ' ')
+        end
+      else
+        result << '----'
+        result << contents
+        result << '----'
+      end
+      result.unshift list_continuation if list_continuation
+      %(#{result.join LF}#{suffix})
+    end
+
+    def convert_ul el, opts
+      # TODO create do_in_level block
+      level = opts[:level] ? (opts[:level] += 1) : (opts[:level] = 1)
+      # REVIEW this is whack
+      prefix = (parent = opts[:parent]) && parent.type == :li && !opts[:result][-1] ? LF : ''
+      contents = inner el, (opts.merge rstrip: true)
+      if level == 1
+        suffix = LFx2
+        opts.delete :level
+      else
+        suffix = LF
+        opts[:level] -= 1
+      end
+      %(#{prefix}#{contents}#{suffix})
+    end
+
+    alias convert_ol convert_ul
+
+    def convert_li el, opts
+      prefix = (prev = opts[:prev]) && prev.options[:compound] ? LF : ''
+      marker = opts[:parent].type == :ol ? '.' : '*'
+      indent = (level = opts[:level]) - 1
+      %(#{prefix}#{indent > 0 ? (' ' * indent) : ''}#{marker * level} #{(inner el, (opts.merge rstrip: true))}#{LF})
+    end
+
+    def convert_table el, opts
+      head = cols = nil
+      table_buf = ['|===']
+      el.children.each do |container|
+        container.children.each do |row|
+          row_buf = []
+          row.children.each do |cell|
+            row_buf << %(| #{inner cell, opts})
+          end
+          cols = row_buf.size unless cols
+          if container.type == :thead
+            head = true
+            row_buf = [row_buf * ' ']
+          end
+          row_buf << ''
+          table_buf.concat row_buf
+        end
+      end
+      table_buf.unshift %([cols=#{cols}*]) unless head
+      table_buf.pop if table_buf[-1] == ''
+      table_buf << '|==='
+      %(#{table_buf * LF}#{LFx2})
+    end
+
+    def convert_hr el, opts
+      %('''#{LFx2})
+    end
+
+    def convert_text el, opts
+      if (result = el.value).include? '++'
+        @attributes['pp'] = '{plus}{plus}'
+        result = result.gsub '++', '{pp}'
+      end
+      result = result.gsub '<=', '\\<=' if result.include? '<='
+      if result.ascii_only?
+        result
+      else
+        (result.gsub ApostropheRx, ?').gsub TypographicSymbolRx, TYPOGRAPHIC_SYMBOL_TO_MARKUP
+      end
+    end
+
+    def convert_codespan el, opts
+      (val = el.value) =~ ReplaceableTextRx ? %(`+#{val}+`) : %(`#{val}`)
+    end
+
+    def convert_em el, opts
+      %(_#{inner el, opts}_)
+    end
+
+    def convert_strong el, opts
+      %(*#{inner el, opts}*)
+    end
+
+    # NOTE this logic assumes the :hard_wrap option is disabled in the parser
+    def convert_br el, opts
+      prefix = ((opts[:result][-1] || '').end_with? ' ') ? '' : ' '
+      # if @attr is set, this is a <br> HTML tag
+      if el.instance_variable_get :@attr
+        siblings = opts[:parent].children
+        suffix = (next_el = siblings[(siblings.index el) + 1] || VoidElement).type == :text && (next_el.value.start_with? LF) ? '' : LF
+      else
+        suffix = ''
+      end
+      %(#{prefix}+#{suffix})
+    end
+
+    def convert_smart_quote el, opts
+      SMART_QUOTE_ENTITY_TO_MARKUP[el.value]
+    end
+
+    def convert_entity el, opts
+      RESOLVE_ENTITY_TABLE[el.value] || 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
+          convert_img child_i, parent: opts[:parent], index: 0, url: url
+        else
+          ((contents = inner el, opts).chomp '/') == (url.chomp '/') ? url : %(#{url}[#{contents}])
+        end
+      elsif url.end_with? '.md'
+        %(xref:#{url.slice 0, url.length - 3}.adoc[#{inner el, opts}])
+      else
+        %(link:#{url}[#{inner el, opts}])
+      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}) : ''
+      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}])
+    end
+
+    # NOTE leave enabled so we can down-convert mdash to --
+    def convert_typographic_sym el, opts
+      TYPOGRAPHIC_ENTITY_TO_MARKUP[el.value]
+    end
+
+    def convert_html_element el, opts
+      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)
+      when 'sup'
+        %(^#{contents}^)
+      when 'sub'
+        %(~#{contents}~)
+      else
+        %(+++<#{tagname}#{attrs}>+++#{contents}+++</#{tagname}>+++)
+      end
+    end
+
+    def convert_xml_comment el, opts
+      XmlCommentRx =~ el.value
+      comment_text = ($1.include? ' !') ? ($1.gsub CommentPrefixRx, '').strip : $1.strip
+      #siblings = (parent = opts[:parent]) ? parent.children : []
+      if (el.options[:category] == :block)# || (!opts[:result][-1] && siblings[-1] == el)
+        if comment_text.empty?
+          %(//-#{LFx2})
+        elsif comment_text.include? LF
+          %(////#{LF}#{comment_text}#{LF}////#{LFx2})
+        else
+          %(// #{comment_text}#{LFx2})
+        end
+      else
+        if (current_line = opts[:result][-1])
+          if current_line.end_with? LF
+            prefix = ''
+          else
+            prefix = LF
+            opts[:result][-1] = (current_line = current_line.rstrip) if current_line.end_with? ' '
+          end
+        else
+          prefix = ''
+        end
+        siblings = (parent = opts[:parent]) && parent.children
+        suffix = siblings && siblings[(siblings.index el) + 1] ? LF : ''
+        if comment_text.include? LF
+          %(#{prefix}#{comment_text.gsub StartOfLinesRx, '// '}#{suffix})
+        else
+          %(#{prefix}// #{comment_text}#{suffix})
+        end
+      end
+    end
+
+    def inner el, opts
+      rstrip = opts.delete :rstrip
+      result = []
+      prev = nil
+      el.children.each_with_index do |child, idx|
+        result << (send %(convert_#{child.type}), child, (opts.merge parent: el, index: idx, result: result, prev: prev))
+        prev = child
+      end
+      rstrip ? result.join.rstrip : result.join
+    end
+  end
+end; end
+
+Kramdown::Converter::Asciidoc = Kramdown::AsciiDoc::Converter