markdownator 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4799d3266ce18fa6adff8a3264b255a8bcaa2974888e260542adacd709566f2a
-  data.tar.gz: 50f573d19ff4b5407220fe4e8d2b50ebbc481c7d983183e24032ed6a8e4671f4
+  metadata.gz: f3bb73d9071265c3e01fa7103402c07a8a7ebbcf48e765d52e81af03c5214279
+  data.tar.gz: 2a62788cffbb31953bdf6a9026da04fc6b34a2d96cf8b1c66ea7bf999e9409ce
 SHA512:
-  metadata.gz: 71873a123d242b1ff45147fc28eb50300c2dfb82d92dd5939be352dbeb05bbf9ae97c1c7003c5edf606e918176f5fa2dcb53b3f2ef2b0c3e9437a3fdb3faad81
-  data.tar.gz: 2c7aaf6871850fa39e323e32f7da9fe3870e06159fda18e4f04e268231214efd717c88f0cd41d291a07964b705e653cac677459a1921a1258545a68e72fd273e
+  metadata.gz: 806ca5e6247cdd8a3dc0d38d5c976c58adb40cfa5da9670df5c2f91fd0caec8fa73876dbbc77b7a27eb95ae1a275ed749c6c3ab239cb2067dcedf1eacd592738
+  data.tar.gz: 839c22421473002fd50a838a474bca86fcf3506e42fe5d742ccd444954f286babd993ba023043fc8087bf6733cbf70bddce79bcd45f1cd0f6bf1e6ba88ff89cf

data/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-06-13
+
+### Changed
+
+- `nokogiri`, `rubyzip`, `pdf-reader`, and `exifr` are now runtime dependencies,
+  so every supported format works out of the box instead of requiring callers to
+  install the format gems themselves.
+
+## [0.1.2] - 2026-06-13
+
+### Changed
+
+- XLSX conversion now reads the workbook directly with rubyzip and Nokogiri
+  instead of `roo`, so every Office format (DOCX, XLSX, PPTX, EPUB) shares one
+  approach and the `roo` dependency is dropped.
+- Moved the HTML renderer to `Markdownator::Renderers::HtmlRenderer` (it renders
+  Markdown, it does not convert a source file).
+
 ## [0.1.1] - 2026-06-13
 
 ### Changed
@@ -29,6 +47,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   dependencies.
 - Pluggable LLM image-captioner hook (off by default).
 
-[Unreleased]: https://github.com/alexrupom/markdownator/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/alexrupom/markdownator/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/alexrupom/markdownator/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/alexrupom/markdownator/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/alexrupom/markdownator/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/alexrupom/markdownator/releases/tag/v0.1.0

data/Gemfile

@@ -5,17 +5,11 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in markdownator.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
-
-gem "rspec", "~> 3.0"
-
-gem "rubocop", "~> 1.21"
-
-# Optional format libraries, declared here so the test suite can exercise every
-# converter. Applications install only the ones for the formats they use; the
-# gem itself requires them lazily and never depends on them at runtime.
-gem "exifr", "~> 1.3"
-gem "nokogiri", "~> 1.15"
-gem "pdf-reader", "~> 2.12"
-gem "roo", "~> 2.10"
-gem "rubyzip", "~> 2.3"
+# The format libraries are runtime dependencies declared in the gemspec.
+
+# Development and test tooling.
+group :development, :test do
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.0"
+  gem "rubocop", "~> 1.21"
+end

data/README.md

@@ -3,28 +3,28 @@
 Convert files into clean, LLM-friendly **Markdown**. Point Markdownator at a PDF,
 Office document, web page, archive, or image and get Markdown back.
 
-It uses a pluggable converter-registry architecture and loads heavy format
-libraries **lazily**, so you only install the gems for the formats you actually use.
+It uses a pluggable converter-registry architecture, and ships with everything it
+needs — every supported format works out of the box.
 
 ## Supported formats
 
-| Format | Extensions | Extra gem required |
-|--------|------------|--------------------|
-| Plain text / Markdown | `.txt`, `.md` | — (built in) |
-| CSV | `.csv` | — (built in) |
-| JSON | `.json` | — (built in) |
+| Format | Extensions | Backed by |
+|--------|------------|-----------|
+| Plain text / Markdown | `.txt`, `.md` | stdlib |
+| CSV | `.csv` | stdlib |
+| JSON | `.json` | stdlib |
 | HTML | `.html`, `.htm` | `nokogiri` |
 | XML | `.xml` | `nokogiri` |
 | Word | `.docx` | `rubyzip`, `nokogiri` |
-| Excel | `.xlsx` | `roo` |
+| Excel | `.xlsx` | `rubyzip`, `nokogiri` |
 | PowerPoint | `.pptx` | `rubyzip`, `nokogiri` |
 | PDF | `.pdf` | `pdf-reader` |
 | EPUB | `.epub` | `rubyzip`, `nokogiri` |
 | ZIP (recurses) | `.zip` | `rubyzip` |
-| Images (metadata) | `.jpg`, `.png`, `.tiff`, … | `exifr` (for EXIF) |
+| Images (metadata) | `.jpg`, `.png`, `.tiff`, … | `exifr` |
 
-If a required gem is missing, the converter raises `Markdownator::MissingDependencyError`
-telling you exactly what to add to your `Gemfile`.
+These libraries (`nokogiri`, `rubyzip`, `pdf-reader`, `exifr`) are runtime
+dependencies, so they are installed with the gem automatically.
 
 ## Installation
 
@@ -32,14 +32,10 @@ telling you exactly what to add to your `Gemfile`.
 gem "markdownator"
 ```
 
-Then add the gems for the formats you need, e.g.:
+or:
 
-```ruby
-gem "pdf-reader"      # PDF
-gem "roo"             # XLSX
-gem "rubyzip"         # DOCX, PPTX, EPUB, ZIP
-gem "nokogiri"        # HTML, XML, DOCX, PPTX, EPUB
-gem "exifr"           # image EXIF
+```sh
+gem install markdownator
 ```
 
 ## Usage

data/lib/markdownator/converters/html.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "html_renderer"
+require_relative "../renderers/html_renderer"
 
 module Markdownator
   module Converters
@@ -20,7 +20,7 @@ module Markdownator
         Markdownator.require_optional("nokogiri", feature: "HTML conversion")
         doc = Nokogiri::HTML(html)
         root = doc.at_css("body") || doc.root || doc
-        HtmlRenderer.new.render(root)
+        Renderers::HtmlRenderer.new.render(root)
       end
 
       def self.extract_title(html)

data/lib/markdownator/converters/xlsx.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
-require "tempfile"
-
 module Markdownator
   module Converters
     # Converts an Excel .xlsx workbook into Markdown: one `## SheetName` heading
-    # and a Markdown table per sheet, using the `roo` gem.
+    # and a Markdown table per sheet.
+    #
+    # Reads the OOXML zip directly with rubyzip and Nokogiri, the same approach
+    # used by the DOCX, PPTX, and EPUB converters.
     class Xlsx < Base
       def accepts?(_io, stream_info)
         matches?(
@@ -16,12 +17,16 @@ module Markdownator
       end
 
       def convert(io, _stream_info, **_options)
-        Markdownator.require_optional("roo", feature: "XLSX conversion")
+        Markdownator.require_optional("zip", feature: "XLSX conversion")
+        Markdownator.require_optional("nokogiri", feature: "XLSX conversion")
 
-        with_tempfile(io) do |path|
-          workbook = Roo::Excelx.new(path)
-          sections = workbook.sheets.map { |name| render_sheet(workbook, name) }
-          Result.new(markdown: sections.compact.join("\n\n"))
+        ::Zip::File.open_buffer(io) do |zip|
+          shared = shared_strings(zip)
+          sections = sheets(zip).filter_map do |name, path|
+            table = markdown_table(parse_sheet(read(zip, path), shared))
+            "## #{name}\n\n#{table}" unless table.empty?
+          end
+          return Result.new(markdown: sections.join("\n\n"))
         end
       rescue StandardError => e
         raise FileConversionError, "Could not read XLSX: #{e.message}"
@@ -29,23 +34,85 @@ module Markdownator
 
       private
 
-      def render_sheet(workbook, name)
-        sheet = workbook.sheet(name)
-        rows = (1..sheet.last_row.to_i).map do |r|
-          (1..sheet.last_column.to_i).map { |c| sheet.cell(r, c) }
+      def read(zip, path)
+        zip.find_entry(path)&.get_input_stream&.read
+      end
+
+      # Ordered [[sheet_name, worksheet_path], ...] resolved via the workbook
+      # relationships.
+      def sheets(zip)
+        workbook = parse(read(zip, "xl/workbook.xml"))
+        return [] if workbook.nil?
+
+        rels = relationships(zip)
+        workbook.xpath("//sheets/sheet").filter_map do |sheet|
+          path = resolve_target(rels[sheet["id"]])
+          [sheet["name"].to_s, path] if path
         end
-        table = markdown_table(rows)
-        table.empty? ? nil : "## #{name}\n\n#{table}"
       end
 
-      def with_tempfile(io)
-        Tempfile.create(["markdownator", ".xlsx"]) do |file|
-          file.binmode
-          file.write(io.read)
-          file.flush
-          yield file.path
+      def relationships(zip)
+        doc = parse(read(zip, "xl/_rels/workbook.xml.rels"))
+        return {} if doc.nil?
+
+        doc.xpath("//Relationship").to_h { |rel| [rel["Id"], rel["Target"]] }
+      end
+
+      def resolve_target(target)
+        return nil if target.nil? || target.empty?
+
+        target = target.delete_prefix("/")
+        target.start_with?("xl/") ? target : "xl/#{target}"
+      end
+
+      # The shared string table: index -> text.
+      def shared_strings(zip)
+        doc = parse(read(zip, "xl/sharedStrings.xml"))
+        return [] if doc.nil?
+
+        doc.xpath("//si").map { |si| si.xpath(".//t").map(&:text).join }
+      end
+
+      def parse_sheet(xml, shared)
+        doc = parse(xml)
+        return [] if doc.nil?
+
+        doc.xpath("//sheetData/row").map do |row|
+          values = {}
+          width = 0
+          row.xpath("./c").each_with_index do |cell, position|
+            column = column_index(cell["r"]) || (position + 1)
+            width = column if column > width
+            values[column] = cell_value(cell, shared)
+          end
+          (1..width).map { |i| values[i] || "" }
+        end
+      end
+
+      def cell_value(cell, shared)
+        case cell["t"]
+        when "s" then shared[cell.at_xpath("./v")&.text.to_i].to_s
+        when "inlineStr" then cell.xpath("./is//t").map(&:text).join
+        when "b" then cell.at_xpath("./v")&.text == "1" ? "TRUE" : "FALSE"
+        else cell.at_xpath("./v")&.text.to_s
         end
       end
+
+      # Converts a cell reference like "B2" into a 1-based column index (2).
+      def column_index(ref)
+        letters = ref.to_s[/\A[A-Z]+/i]
+        return nil if letters.nil?
+
+        letters.upcase.each_char.reduce(0) { |acc, char| (acc * 26) + (char.ord - 64) }
+      end
+
+      def parse(xml)
+        return nil if xml.nil?
+
+        doc = Nokogiri::XML(xml)
+        doc.remove_namespaces!
+        doc
+      end
     end
   end
 end

data/lib/markdownator/{converters → renderers}/html_renderer.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Markdownator
-  module Converters
+  module Renderers
     # Walks a Nokogiri HTML node tree and renders Markdown. A focused,
     # dependency-free replacement for reverse_markdown: HTML conversion needs
     # only Nokogiri (which reverse_markdown depended on anyway).

data/lib/markdownator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markdownator
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/markdownator.gemspec

@@ -32,8 +32,9 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # Heavy format gems are intentionally NOT runtime dependencies. Each converter
-  # requires its gem lazily and raises a helpful error if it is missing, so apps
-  # install only what they need. The gems used to exercise every format in the
-  # test suite are declared as development dependencies in the Gemfile.
+  # Format libraries used by the converters.
+  spec.add_dependency "exifr", "~> 1.3" # image metadata
+  spec.add_dependency "nokogiri", "~> 1.15" # HTML, XML, DOCX, XLSX, PPTX, EPUB
+  spec.add_dependency "pdf-reader", "~> 2.12" # PDF
+  spec.add_dependency "rubyzip", "~> 2.3" # DOCX, XLSX, PPTX, EPUB, ZIP
 end

metadata

@@ -1,15 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: markdownator
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - alexrupom
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-12 00:00:00.000000000 Z
-dependencies: []
+date: 2026-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: exifr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: pdf-reader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 description: Markdownator converts PDF, Word, Excel, PowerPoint, EPUB, HTML, CSV,
   JSON, XML, ZIP archives and images into clean Markdown suitable for large language
   models, using a pluggable converter architecture.
@@ -33,7 +89,6 @@ files:
 - lib/markdownator/converters/docx.rb
 - lib/markdownator/converters/epub.rb
 - lib/markdownator/converters/html.rb
-- lib/markdownator/converters/html_renderer.rb
 - lib/markdownator/converters/image.rb
 - lib/markdownator/converters/json.rb
 - lib/markdownator/converters/pdf.rb
@@ -44,6 +99,7 @@ files:
 - lib/markdownator/converters/zip.rb
 - lib/markdownator/engine.rb
 - lib/markdownator/errors.rb
+- lib/markdownator/renderers/html_renderer.rb
 - lib/markdownator/result.rb
 - lib/markdownator/stream_info.rb
 - lib/markdownator/version.rb