kramdown-ansi 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 737af675856867287e33a53bf18bbb08517b3743900132f826b77cdad9b47c01
-  data.tar.gz: f533ff7b8927579aead7c482039813091cf55796621febd5658a5c469d7e0957
+  metadata.gz: 6d35fcfbc735d86a3f58f59c1eaded0ebdc4f706db3cedb0c807aa6f9f420fe8
+  data.tar.gz: cd32746d6d592ee48e59bda8211adf670bdef612a5c65da97e114234ef8f0e83
 SHA512:
-  metadata.gz: 5578a1e962bf25fbc54f00be909cb53a647bc3e56f67934a984c37f8c4a156e1dd499e446aa549817c35fd83c26c31a0f975319b06dcc7e556e73ba39b5be9cf
-  data.tar.gz: b48b3cab8c7d2c05181efe12cd794be25a59d1319aaaa6ad26ae2a31b7a54311153f24076ae109a696c5cec791c958b6e6eba84bc2f3c9823c5feec9916ee825
+  metadata.gz: d7607e68a92ac9d968febb1179c60a291550306b56ada967fd29f2c9f1dd413f6d18981895b358b5a0ac34bdaae0291d1ed7e452a76dbe52329582fc11b11dc5
+  data.tar.gz: 07b078aad8c0e3d0b9cf1b509b9f21dc4a2cbdbf3101f4997a079349fb7272848fe58080a18ab4e79c4b13b07061cbe61dfb43c511b8630eb73c077a6ecb866b

data/.utilsrc

@@ -41,7 +41,6 @@ code_indexer do
     date
     debug
     diff-lcs
-    docile
     erb
     excon
     fileutils
@@ -79,8 +78,6 @@ code_indexer do
     search_ui
     shellwords
     simplecov
-    simplecov-html
-    simplecov_json_formatter
     stringio
     sync
     term-ansicolor

data/CHANGES.md

@@ -1,5 +1,99 @@
 # Changes
 
+## 2026-10-22 v0.7.0
+
+### Fixes
+
+- Fixed GFM table parsing for non-header tables by rendering `:table` elements
+  without a `:thead` as plain text, as GFM requires a header row and delimiter
+  row for a valid table.
+- Corrected table continuation detection in `self.parse` by checking if the
+  next line contains a `|`, resolving issues where delimiter or body rows
+  lacked a leading pipe (e.g., `:---|---:`, `1 | 2`).
+
+### Improvements
+
+- Replaced `Regexp.last_match` calls with direct captured group assignments
+  (`$1`, `$2`) in `ansi.rb` for clarity.
+
+### Build & CI
+
+- Added `scripts/capture-ansi` and `.envrc` for local golden file regeneration.
+- Added `.envrc` and `scripts/*` to `package_ignore` in `Rakefile`.
+
+### Testing
+
+- Added Case 27 (pipe in a sentence) to `spec/assets/tables.md` and regenerated
+  `spec/assets/tables.ansi`.
+
+## 2026-10-21 v0.6.0
+
+### Features
+
+- Add support for nested blockquotes with cycling typographic quotation marks
+  based on nesting depth.
+- Add ANSI styling support for HTML elements: `ins`/`u` (underline), `mark`
+  (negative/inverse), `tt` (code), `small` (faint), and passthrough for
+  `span`/`sub`/`sup`.
+- Add strikethrough support for `del` and `s` HTML elements.
+- Introduce `ProtectEnvVars` module in test helper to isolate environment
+  variable changes during tests tagged with `:protect_env`.
+
+### Fixes
+
+- Fix GFM table parsing by inserting required blank lines before and after pipe
+  tables to ensure correct recognition by `kramdown`.
+- Fix `Integer#size` regression in table column width calculation by using
+  `display_width` directly instead of `.size`, ensuring correct column ratios
+  on Ruby 4.
+- Fix empty table cell rendering by replacing empty strings with a single space
+  and falling back to equal-width splits when total width is zero.
+- Fix typo in `convert_html_element` where `e.value` was used instead of
+  `el.value` for the `del`/`s` branch.
+- Make `Token` definition in `Kramdown::ANSI::Width` compatible with Ruby
+  versions lacking `Data` by providing a `Struct`-based fallback.
+
+### Improvements
+
+- Rewrite `Kramdown::ANSI::Width#truncate` to be ANSI-aware, correctly handling
+  escape sequences, wide characters (emojis), and zero-width characters using
+  `display_width`.
+- Optimize `wrap` and `truncate` methods by using `scan` instead of `gsub` to
+  reduce allocation.
+- Generalize the `capture:tables` Rake task to `capture:ansi` to regenerate
+  golden files for all `spec/assets/*.md` fixtures.
+- Update `README.md` style examples to include `blockquote` and add a nested
+  dialog example.
+
+### Build & CI
+
+- Add `tins` gem (`~> 1.61`) as a runtime dependency.
+- Upgrade `gem_hadar` development dependency to `>= 2.20.1`.
+- Update `rubygems_version` in gemspec to **4.0.22**.
+- Remove unused gems (`docile`, `simplecov-html`, `simplecov_json_formatter`)
+  from `.utilsrc`.
+- Add `git config --global --add safe.directory /work` to Docker test script.
+- Use `nproc` instead of `getconf _NPROCESSORS_ONLN` for CPU count in Docker
+  test script.
+- Add `tmp/.gitkeep` to track the empty `tmp` directory.
+
+### Testing
+
+- Add `spec/kramdown/render_spec.rb` to test `Kramdown::ANSI.parse` for
+  headers, inline emphasis, code blocks, blockquotes, horizontal rules, lists,
+  links, images, and paragraphs.
+- Add `spec/assets/tables.md` and `spec/assets/tables.ansi` golden files
+  covering 26 edge cases for table rendering.
+- Add `spec/kramdown/ansi_golden_spec.rb` for output regression testing against
+  golden files.
+- Add `spec/assets/html.md` and `spec/assets/html.ansi` golden files covering
+  HTML element styling.
+- Add 9 new specs for `Kramdown::ANSI::Width#truncate` covering wide emojis,
+  empty strings, pure ANSI, zero-width characters, newline preservation,
+  multi-cell ellipsis, nested-style reset, and post-cut escape omission.
+- Stub `Tins::Terminal.columns` to 80 in `ansi_spec.rb` and `render_spec.rb`
+  for deterministic output.
+
 ## 2026-03-21 v0.5.0
 
 - Added `spec/kramdown/ansi_table_spec.rb` to the test suite and gemspec file

data/README.md

@@ -47,10 +47,11 @@ You can customize the ANSI styles by passing an `ansi_styles` option:
 require 'kramdown/ansi'
 
 ansi_styles = {
-  header: [:bold, :magenta],
-  strong: :green,
-  em:     :yellow,
-  code:   [:cyan, :underline]
+  header:     [:bold, :magenta],
+  strong:     :green,
+  em:         :yellow,
+  code:       [:cyan, :underline],
+  blockquote: :blue,
 }
 
 puts Kramdown::ANSI.parse(markdown, ansi_styles:)
@@ -65,7 +66,7 @@ methods:
 require 'kramdown/ansi'
 
 # Using from_json method
-json_config = '{"header": ["bold", "magenta"], "code": ["cyan", "underline"]}'
+json_config = '{"header": ["bold", "magenta"], "code": ["cyan", "underline"], "blockquote": ["magenta", "underline"]}'
 ansi_styles = Kramdown::ANSI::Styles.from_json(json_config)
 
 # Apply to parsing
@@ -177,6 +178,10 @@ The homepage of this library is located at
 
 ![cat](./spec/assets/kitten.jpg)
 
+Dialog:
+> What's that, Fluffy?
+>> That's my new friend.
+
 ---
 
 This is the end.

data/Rakefile

@@ -19,7 +19,7 @@ GemHadar do
     '.yardoc', 'doc', 'tags', 'errors.lst', 'cscope.out', 'coverage', 'tmp',
     'yard'
   package_ignore '.all_images.yml', '.tool-versions', '.gitignore', 'VERSION',
-    '.rspec', '.github'
+    '.rspec', '.github', '.envrc', 'scripts/*'
   readme      'README.md'
 
   executables << 'md' << 'git-md'
@@ -37,6 +37,7 @@ GemHadar do
   dependency             'term-ansicolor',        '~> 1.11'
   dependency             'kramdown-parser-gfm',   '~> 1.1'
   dependency             'terminal-table',        '~> 4.0'
+  dependency             'tins',                  '~> 1.61'
   dependency             'json',                  '~> 2.0'
   dependency             'unicode-display_width', '~> 3.0'
   development_dependency 'all_images',            '~> 0.4'
@@ -48,3 +49,21 @@ GemHadar do
 
   clobber 'coverage'
 end
+
+namespace :capture do
+  desc 'Capture golden file ansi output for all spec/assets/*.md files'
+  task :ansi do
+    require 'kramdown/ansi'
+    module Tins::Terminal
+      def self.columns
+        80
+      end
+    end
+    Dir[File.join('spec', 'assets', '*.md')].sort.each do |md|
+      out_path = md.sub('.md', '.ansi')
+      out = Kramdown::ANSI.parse(File.read(md))
+      File.write(out_path, out)
+      puts "Captured #{out_path} (#{out.bytesize} bytes)"
+    end
+  end
+end

data/kramdown-ansi.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: kramdown-ansi 0.5.0 ruby lib
+# stub: kramdown-ansi 0.7.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "kramdown-ansi".freeze
-  s.version = "0.5.0".freeze
+  s.version = "0.7.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -13,18 +13,18 @@ Gem::Specification.new do |s|
   s.email = "flori@ping.de".freeze
   s.executables = ["md".freeze, "git-md".freeze]
   s.extra_rdoc_files = ["README.md".freeze, "lib/kramdown/ansi.rb".freeze, "lib/kramdown/ansi/pager.rb".freeze, "lib/kramdown/ansi/styles.rb".freeze, "lib/kramdown/ansi/width.rb".freeze, "lib/kramdown/version.rb".freeze]
-  s.files = [".utilsrc".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/git-md".freeze, "bin/md".freeze, "img/git-md.png".freeze, "img/md.png".freeze, "kramdown-ansi.gemspec".freeze, "lib/kramdown/ansi.rb".freeze, "lib/kramdown/ansi/pager.rb".freeze, "lib/kramdown/ansi/styles.rb".freeze, "lib/kramdown/ansi/width.rb".freeze, "lib/kramdown/version.rb".freeze, "spec/assets/README.ansi".freeze, "spec/assets/kitten.jpg".freeze, "spec/kramdown/ansi/pager_spec.rb".freeze, "spec/kramdown/ansi/styles_spec.rb".freeze, "spec/kramdown/ansi/width_spec.rb".freeze, "spec/kramdown/ansi_spec.rb".freeze, "spec/kramdown/ansi_table_spec.rb".freeze, "spec/spec_helper.rb".freeze]
+  s.files = [".utilsrc".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/git-md".freeze, "bin/md".freeze, "img/git-md.png".freeze, "img/md.png".freeze, "kramdown-ansi.gemspec".freeze, "lib/kramdown/ansi.rb".freeze, "lib/kramdown/ansi/pager.rb".freeze, "lib/kramdown/ansi/styles.rb".freeze, "lib/kramdown/ansi/width.rb".freeze, "lib/kramdown/version.rb".freeze, "scripts/capture-ansi".freeze, "spec/assets/README.ansi".freeze, "spec/assets/html.ansi".freeze, "spec/assets/html.md".freeze, "spec/assets/kitten.jpg".freeze, "spec/assets/tables.ansi".freeze, "spec/assets/tables.md".freeze, "spec/kramdown/ansi/pager_spec.rb".freeze, "spec/kramdown/ansi/styles_spec.rb".freeze, "spec/kramdown/ansi/width_spec.rb".freeze, "spec/kramdown/ansi_golden_spec.rb".freeze, "spec/kramdown/ansi_spec.rb".freeze, "spec/kramdown/ansi_table_spec.rb".freeze, "spec/kramdown/render_spec.rb".freeze, "spec/spec_helper.rb".freeze, "tmp/.gitkeep".freeze]
   s.homepage = "https://github.com/flori/kramdown-ansi".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "Kramdown-ansi - Output markdown in the terminal with ANSI escape sequences".freeze, "--main".freeze, "README.md".freeze]
   s.required_ruby_version = Gem::Requirement.new(">= 3.1".freeze)
-  s.rubygems_version = "4.0.8".freeze
+  s.rubygems_version = "4.0.22".freeze
   s.summary = "Output markdown in the terminal with ANSI escape sequences".freeze
-  s.test_files = ["spec/kramdown/ansi/pager_spec.rb".freeze, "spec/kramdown/ansi/styles_spec.rb".freeze, "spec/kramdown/ansi/width_spec.rb".freeze, "spec/kramdown/ansi_spec.rb".freeze, "spec/kramdown/ansi_table_spec.rb".freeze, "spec/spec_helper.rb".freeze]
+  s.test_files = ["spec/kramdown/ansi/pager_spec.rb".freeze, "spec/kramdown/ansi/styles_spec.rb".freeze, "spec/kramdown/ansi/width_spec.rb".freeze, "spec/kramdown/ansi_golden_spec.rb".freeze, "spec/kramdown/ansi_spec.rb".freeze, "spec/kramdown/ansi_table_spec.rb".freeze, "spec/kramdown/render_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.17.0".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.20.1".freeze])
   s.add_development_dependency(%q<all_images>.freeze, ["~> 0.4".freeze])
   s.add_development_dependency(%q<rspec>.freeze, ["~> 3.2".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
@@ -32,6 +32,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.11".freeze])
   s.add_runtime_dependency(%q<kramdown-parser-gfm>.freeze, ["~> 1.1".freeze])
   s.add_runtime_dependency(%q<terminal-table>.freeze, ["~> 4.0".freeze])
+  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.61".freeze])
   s.add_runtime_dependency(%q<json>.freeze, ["~> 2.0".freeze])
   s.add_runtime_dependency(%q<unicode-display_width>.freeze, ["~> 3.0".freeze])
 end

data/lib/kramdown/ansi/styles.rb

@@ -24,10 +24,15 @@ class Kramdown::ANSI::Styles
   # configuration.
   def initialize
     @default_ansi_styles = {
-      header: %i[ bold underline ],
-      strong: :bold,
-      em:     :italic,
-      code:   :blue,
+      header:     %i[ bold underline ],
+      strong:     :bold,
+      em:         :italic,
+      code:       :blue,
+      blockquote: :faint,
+      del:        :strikethrough,
+      ins:        :underline,
+      mark:       :negative,
+      small:      :faint,
     }
     @ansi_styles = @default_ansi_styles.dup
   end

data/lib/kramdown/ansi/width.rb

@@ -19,20 +19,24 @@ module Kramdown::ANSI::Width
 
   module_function
 
-  # Returns the width of the terminal in characters, given a percentage.
-  #
-  # @param percentage [Numeric] the percentage value (defaults to 100.0)
-  # @return [Integer] the calculated width
-  def width(percentage: 100.0)
-    ((Float(percentage) * Tins::Terminal.columns) / 100).floor
-  end
+  ANSI_ESCAPES = /\e\[.*?m|\e\].*?(\e|\a)\\?/
+
+  private_constant :ANSI_ESCAPES
 
   # Removes ANSI escape sequences from the given string.
   #
   # @param line [String] the string potentially containing ANSI escape codes.
   # @return [String] the string with all ANSI escape sequences removed.
   def remove_ansi_escapes(line)
-    line.to_s.gsub(/\e\[.*?m|\e\].*?(\e|\a)\\?/, '')
+    line.to_s.gsub(ANSI_ESCAPES, '')
+  end
+
+  # Returns the width of the terminal in characters, given a percentage.
+  #
+  # @param percentage [Numeric] the percentage value (defaults to 100.0)
+  # @return [Integer] the calculated width
+  def width(percentage: 100.0)
+    ((Float(percentage) * Tins::Terminal.columns) / 100).floor
   end
 
   # Calculates the display width of a string after removing ANSI escape
@@ -67,8 +71,8 @@ module Kramdown::ANSI::Width
     end
     length = length.clamp(1..)
     length_without_ansi = 0
-    result = ''
-    text.gsub(/(?<nws>\S+)|(?<ws>\s)/) do
+    result = +''
+    text.scan(/(?<nws>\S+)|(?<ws>\s)/) do
       token_value  = $&
       token_length = display_width(token_value)
       if $~[:nws]
@@ -91,6 +95,28 @@ module Kramdown::ANSI::Width
     result
   end
 
+  if defined?(Data)
+    # A frozen data record for a single token in the `truncate` scan.
+    #
+    # +type+ is `:esc` (ANSI escape, zero display width) or
+    # `:txt` (visible character, display width from
+    # `Unicode::DisplayWidth`).
+    # +value+ is the raw matched substring.
+    # +length+ is the display width in terminal columns (0 for escapes).
+    Token = Data.define(:type, :value, :length)
+  else
+    class Token < Struct.new(:type, :value, :length)
+      def initialize(**opts)
+        opts.each do |key, value|
+          self.send("#{key}=", value)
+        end
+        freeze
+      end
+    end
+  end
+
+  private_constant :Token
+
   # Truncates a given string to a specified length or percentage. If the text
   # is longer an ellipsis sequence is added at the end of the generated string,
   # to indicate that a truncation has been performed.
@@ -105,13 +131,59 @@ module Kramdown::ANSI::Width
     percentage.nil? ^ length.nil? or
       raise ArgumentError, "either pass percentage or length argument"
     percentage and length ||= width(percentage:)
-    ellipsis_length = ellipsis.size
-    if length < ellipsis_length
-      +''
-    elsif text.size >= length + ellipsis_length
-      text[0, length - ellipsis_length] + ellipsis
-    else
-      text
+    ellipsis_length = display_width(remove_ansi_escapes(ellipsis))
+    found_esc       = false
+    result          = +''
+
+    return result if text.empty?
+    return result if length < ellipsis_length
+
+    current_length = 0
+    tokens = []
+
+    text.scan(/(?<esc>#{ANSI_ESCAPES})|(?<txt>.)/m) do
+      token = Token.new(
+        type:   $~[:esc] ? :esc : :txt,
+        value:  $&,
+        length: $~[:esc] ? 0 : display_width($&)
+      )
+      tokens << token
+    end
+
+    while token = tokens.shift
+      if token.type == :esc
+        found_esc = true
+        result << token.value
+        next
+      end
+
+      if current_length + token.length == length && tokens.empty?
+        result << token.value
+        current_length += token.length
+        break
+      elsif current_length + token.length + ellipsis_length > length
+        result << ellipsis
+        break
+      elsif current_length + token.length + ellipsis_length == length
+        result << token.value
+        current_length += token.length
+        remaining_text_length = tokens.select { _1.type == :txt }.map(&:length).sum
+        if current_length + remaining_text_length == length
+          next
+        elsif current_length + remaining_text_length > length
+          result << ellipsis
+          break
+        else
+          next
+        end
+      else
+        current_length += token.length
+        result << token.value
+      end
+
     end
+
+    result << reset if found_esc && !result.end_with?(reset)
+    result
   end
 end

data/lib/kramdown/ansi.rb

@@ -91,6 +91,34 @@ class Kramdown::ANSI < Kramdown::Converter::Base
     options = { input: :mygfm, auto_ids: false, entity_output: :as_char }.merge(
       options.transform_keys(&:to_sym)
     )
+    # Insert blank line before GFM pipe tables glued to preceding
+    # content; kramdown requires it to parse the table correctly.
+    #
+    # Matches: a non-table line immediately followed by a table header,
+    # a valid GFM separator row, and at least one body row.
+    # A two-line "table" (header + separator, no body) is not a table
+    # per GFM, so no blank line is inserted.
+    source = source.gsub(
+      /
+      ( [^|\n][^\n]*\n )           # $1: preceding line (not a pipe line)
+      ( \|[^\n]*\n )               # $2: table header (starts with |)
+      ( \|(?:\s*:?-+:?\s*\|)+\n )  # $3: GFM separator + newline
+      ( \|[^\n]* )                 # $4: first body row (starts with |)
+        \n
+      /x,
+      "\\1\n\\2\\3\\4\n"
+    )
+    # Insert blank line after a table's last row when glued to
+    # following content; kramdown requires it to close the table.
+    #
+    # A following line that contains a pipe is likely a table row
+    # (separator or body), so we keep it glued.
+    source = source.gsub(
+      /(\|[^\n]*\n)([^|\n][^\n]*)/
+    ) do |match|
+      row, next_line = $1, $2
+      next_line.include?('|') ? match : "#{row}\n#{next_line}"
+    end
     @doc = Kramdown::Document.new(source, options).to_ansi
   end
 
@@ -253,6 +281,28 @@ class Kramdown::ANSI < Kramdown::Converter::Base
     apply_style(:code) { el.value }
   end
 
+  BLOCKQUOTE_QUOTES = [
+    %w[“ ”],
+    %w[‘ ’],
+    %w[ » « ],
+    %w[ › ‹ ],
+  ].map(&:freeze).freeze
+  private_constant :BLOCKQUOTE_QUOTES
+
+  # Wraps the content of a blockquote level with the corresponding
+  # typographic quotation marks, cycling through a predefined set of
+  # quote pairs based on the nesting depth.
+  #
+  # @param level [ Integer ] the nesting level of the blockquote
+  # @yield [ String ] the inner content to be wrapped in quotation marks
+  # @return [ String ] the content enclosed by the appropriate opening and
+  #   closing quote characters
+  def blockquote_quote(level, &block)
+    quote = BLOCKQUOTE_QUOTES[level % BLOCKQUOTE_QUOTES.size]
+    quote[0] + block.() + quote[1]
+  end
+  private :blockquote_quote
+
   # The convert_blockquote method processes a blockquote element by applying
   # proper formatting.
   #
@@ -266,7 +316,19 @@ class Kramdown::ANSI < Kramdown::Converter::Base
   # @return [String] the formatted blockquote content with quotation marks and
   # proper newlines
   def convert_blockquote(el, opts)
-    newline ?“ + inner(el, opts).sub(/\n+\z/, '') + ?”
+    old_level = opts[:blockquote_level] ||= -1
+    level = opts[:blockquote_level] = old_level + 1
+    if level.zero?
+      newline(
+        blockquote_quote(level) {
+          apply_style(:blockquote) { inner(el, opts).strip }
+        }.gsub(/^/, ' ')
+      )
+    else
+      blockquote_quote(level) { inner(el, opts).strip }.gsub(/^/, ' ')
+    end
+  ensure
+    opts[:blockquote_level] = old_level
   end
 
   # The convert_hr method processes a horizontal rule element by generating a
@@ -373,6 +435,18 @@ class Kramdown::ANSI < Kramdown::Converter::Base
       apply_style(:em) { inner(el, opts) }
     elsif el.value == 'b' || el.value == 'strong'
       apply_style(:strong) { inner(el, opts) }
+    elsif el.value == 'ins' || el.value == 'u'
+      apply_style(:ins) { inner(el, opts) }
+    elsif el.value == 'mark'
+      apply_style(:mark) { inner(el, opts) }
+    elsif el.value == 'del' || el.value == 's'
+      apply_style(:del) { inner(el, opts) }
+    elsif el.value == 'tt'
+      apply_style(:code) { inner(el, opts) }
+    elsif el.value == 'small'
+      apply_style(:small) { inner(el, opts) }
+    elsif %w[ span sub sup ].include?(el.value)
+      inner(el, opts)
     else
       ''
     end
@@ -386,6 +460,18 @@ class Kramdown::ANSI < Kramdown::Converter::Base
   # @param opts [Hash] conversion options containing context for processing
   # @return [String] the formatted table content with proper styling and newlines
   def convert_table(el, opts)
+    # Kramdown's base parser is more permissive than GFM: it accepts
+    # any pipe-delimited line as a table row, even without a header.
+    # GFM mandates a header + separator row minimum, so a :table
+    # element without :thead is just pipe-separated prose.
+    unless el.children.any? { |c| c.type == :thead }
+      rows = el.children.select { |c| c.type == :tbody }.flat_map do |tbody|
+        tbody.children.map do |row|
+          row.children.map { |cell| convert(cell, opts).strip }.join(' | ')
+        end
+      end
+      return newline rows.join("\n")
+    end
     table = Terminal::Table.new
     table.style = {
       all_separators: true,
@@ -457,13 +543,22 @@ class Kramdown::ANSI < Kramdown::Converter::Base
   # addition of the row to the table instance
   def convert_tr(el, opts)
     return '' if el.children.empty?
-    cols = el.children.map { |c| convert(c, opts).strip }
+    cols = el.children.map do |c|
+      stripped = convert(c, opts).strip
+      stripped.empty? ? ' ' : stripped
+    end
     return '' if cols.empty?
-    col_widths        = cols.map { |c| display_width(c).size }
+    col_widths     = cols.map { |c| display_width(c) }
     col_widths_sum = col_widths.sum
-    full_width = width(percentage: 90)
-    ratios = cols.each_with_index.map { |c, i| col_widths[i] / col_widths_sum.to_f }
-    wrapped_cols = cols.zip(ratios).map { |c, r| wrap(c, length: r * full_width) }
+    full_width     = width(percentage: 90)
+    ratios         = cols.each_with_index.map do |c, i|
+      if col_widths_sum.zero?
+        1.0 / cols.size
+      else
+        col_widths[i] / col_widths_sum.to_f
+      end
+    end
+    wrapped_cols   = cols.zip(ratios).map { |c, r| wrap(c, length: r * full_width) }
     opts[:table] << wrapped_cols
     ''
   end

data/lib/kramdown/version.rb

@@ -1,6 +1,11 @@
+# Version information for the Kramdown gem.
+#
+# This module is auto-generated by GemHadar and exposes the
+# current release version as a set of constants. Do not edit it
+# by hand; it is rewritten on every `rake version` invocation.
 module Kramdown
-  # Kramdown version
-  VERSION         = '0.5.0'
+  # The current version of the Kramdown gem as a String.
+  VERSION         = '0.7.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/scripts/capture-ansi

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+exec bundle exec ruby -I lib -S rake capture:ansi

data/spec/assets/html.ansi

@@ -0,0 +1,28 @@
+HTML Elements
+
+Emphasis
+
+italic i and italic em
+
+Strong
+
+bold b and bold strong
+
+Strikethrough
+
+strikethrough and html s tag and del tag
+
+Underline
+
+Code
+
+tt text
+
+Mark
+
+marked
+
+Passthrough (no style)
+
+span text and subscript and superscript
+and small text

data/spec/assets/html.md

@@ -0,0 +1,28 @@
+# HTML Elements
+
+## Emphasis
+
+<i>italic i</i> and <em>italic em</em>
+
+## Strong
+
+<b>bold b</b> and <strong>bold strong</strong>
+
+## Strikethrough
+
+~~strikethrough~~ and <s>html s tag</s> and <del>del tag</del>
+
+## Underline
+
+## Code
+
+<tt>tt text</tt>
+
+## Mark
+
+<mark>marked</mark>
+
+## Passthrough (no style)
+
+<span>span text</span> and <sub>subscript</sub> and <sup>superscript</sup>
+and <small>small text</small>