mddir 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: abb02fa2e52354eec94c383286dafe3954463784612e7774f85ae00317c5e464
-  data.tar.gz: f094863fee5535ad5faf6e4d8504acba9a9f0655126266be6efda373c49aa396
+  metadata.gz: e6aac0b080aaf3ec9e7b1c912cfabed017b5379610be25ba5ccf865925b061f7
+  data.tar.gz: 7a80416b4d19a80e6de0448877b5f6d9b8ab650ed967ae231579fe808c7cbd69
 SHA512:
-  metadata.gz: 0272dee5640a128756c89fd0819e4d95759c59c20408fffa72cdf27b6aa3812aea6f3be7c62417277c1a8ef9698ea3fbd06a53e4a7ce14d99444380ae3010345
-  data.tar.gz: 525bd1a4c3c1d29a1d19e753cd1ed159f9b4170b589b041955ea40afa8e37b71e8364e361912446b40255fdd19d8feb9128192d6e8f36ce8c2edf6871df9de05
+  metadata.gz: fcade5ae9ef5dbc11091d817efcdf82bb4a848a9540dac5f9e919afc95b8ccd46b0b96106872af66d0490f9180fa9e4c699ba51cbe5fbe100d1e59689774f78e
+  data.tar.gz: ae7f69a7861fb375b45aa7abf64ae781429121cc49053c37cc5d943be02af1765118ed7f4043292b40f813fe34bc18af203370336ee83ffcf6fba2dd1dbf9b9a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.1] - 2026-03-01
+
+- Fix broken image markdown from pages using `<picture>` elements (e.g. Substack)
+
 ## [0.2.0] - 2026-03-01
 
 - Lazy load dependencies to speed up Tebako binaries

data/README.md

@@ -17,15 +17,32 @@ mddir fetches web pages, converts them to clean markdown, and organizes them int
 
 ## Installation
 
-Requires Ruby >= 3.2.0. If you don't have Ruby installed, [mise](https://mise.jdx.dev) is the easiest way to get it:
+### Homebrew (macOS)
 
 ```bash
-mise use --global ruby@3
+brew install AliOsm/tap/mddir
+```
+
+### Standalone Binary (macOS & Linux)
+
+Download the latest binary for your platform from the [GitHub releases page](https://github.com/AliOsm/mddir/releases), then:
+
+```bash
+# macOS: remove the quarantine flag
+xattr -d com.apple.quarantine mddir
+
+chmod +x mddir
+sudo mv mddir /usr/local/bin/
 ```
 
-Then install the gem:
+On Linux, skip the `xattr` step.
+
+### RubyGems
+
+Requires Ruby >= 3.2.0. If you don't have Ruby installed, [mise](https://mise.jdx.dev) is the easiest way to get it:
 
 ```bash
+mise use --global ruby@3
 gem install mddir
 ```
 

data/lib/mddir/fetcher.rb

@@ -128,7 +128,8 @@ module Mddir
     def process_html_response(url, response)
       html = normalize_encoding(response.body.to_s, response.headers["content-type"])
       document = Nokogiri::HTML(html)
-      title, article_html = extract_readable_content(html, document)
+      simplify_image_markup(document)
+      title, article_html = extract_readable_content(document.to_html, document)
       markdown = html_to_markdown(article_html)
 
       Entry.new(
@@ -142,6 +143,20 @@ module Mddir
       )
     end
 
+    def simplify_image_markup(document)
+      document.css("picture").each do |picture|
+        img = picture.at("img")
+        img ? picture.replace(img) : picture.remove
+      end
+
+      document.css("a").each do |a|
+        img = a.at("img")
+        next unless img
+
+        a.replace(img) if a.text.strip.empty?
+      end
+    end
+
     def extract_readable_content(html, document)
       title, article_html = run_readability(html)
 

data/lib/mddir/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mddir
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mddir
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Ali Hamdi Ali Fadel