mdless 2.1.64 → 2.1.66

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61c5d8821a192399e2b85ac727b26e31b154414cf0e14ec71d07b686c0806179
-  data.tar.gz: 3487c52d8dd4feaaccdbe383fb90afc7b6cc6820dc3eb511b5e27a36630cf764
+  metadata.gz: 10e5cba01868258962b2953db75108db724dafda91d83363aff726fbae1056e2
+  data.tar.gz: 781055ed8f03a4f62403a26cd3dde900b6babd4c3fc132544b01d9f81d95119a
 SHA512:
-  metadata.gz: 2ff5faacaf20b4687043b9c1caa8fe8496d01b11398c7717620b265aa80a9fdb25867b0d2046e98bcb4b2d0ac7867aad52ee402cd9b8d5ef0f211115e3da9c82
-  data.tar.gz: 81512704d042815e9162ad3406c86648617f01bd5de57a1c6a26889f403b83734c5a33817fe32ef24f3e5ed59f29d868a3f189d64f03c6b286afe671c616fd28
+  metadata.gz: 9ba9480f94b687bcb8cd766ae606ae1938105b8b28171e4f39163cf2e6afccfd9cf850eecb908190b67e447828eeb29f7340ee080770614f56e7e44d53d4f1ab
+  data.tar.gz: aef9b191cf2f5bc86c0f478a9b9b19e7e5746f8c44478664febfef10bdb0aa4487cd78cfcaaba90beb840f3d91c47c4c8a47fa84f5beb29beb46b60d91a1d03c

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+2.1.66
+
+2.1.65
+: add nbsp_padding flag to toggle Non breaking space characters as right-padding
+: for code blocks.
+
+2.1.64
+
+2.1.63
+: Missing logger in Ruby 4.0.1, added to gemspec
+
 2.1.60
 
 2.1.61
@@ -244,8 +255,3 @@
 : Better language detection for code blocks
 : when available, use italic font for italics and bold-italics emphasis
 : new colorization for html tags
-
-2.1.63
-: Missing logger in Ruby 4.0.1, added to gemspec
-
-2.1.64

data/README.md

@@ -82,6 +82,8 @@ The pager used is determined by system configuration in this order of preference
         --links=FORMAT               Link style ([inline, reference, paragraph], default inline,
                 "paragraph" will position reference links after each paragraph)
         --[no-]linebreaks            Preserve line breaks
+        --[no-]nbsp-padding          Pad code blocks and metadata headers with non-breaking spaces
+                                     (default on; disable for clipboard-safe yank+paste in tmux et al)
         --[no-]syntax                Syntax highlight code blocks
         --taskpaper=OPTION           Highlight TaskPaper format (true|false|auto)
         --update_config              Update the configuration file with new keys and current command line options
@@ -101,6 +103,7 @@ The first time mdless is run, a config file will be written to `~/.config/mdless
 :lax_spacing: true
 :links: :paragraph
 :local_images: true
+:nbsp_padding: true
 :pager: true
 :preserve_linebreaks: false
 :remote_images: false
@@ -119,6 +122,7 @@ The first time mdless is run, a config file will be written to `~/.config/mdless
 - `:lax_spacing` determines whether a blank line is required around HTML elements.
 - `:links` can be `inline`, `reference`, or `paragraph`. Paragraph puts reference links directly after the graf that refers to them.
 - `:local_images` determines whether local images are processed using `chafa` or `imgcat` (whichever is available). `:remote_images` does the same for images referenced with web urls. If `:remote_images` is true, then `:local_images` is automatically enabled.
+- `:nbsp_padding` controls the character used to right-pad fenced code blocks and metadata header lines out to a uniform block width. When `true` (the default, preserving historical behavior), padding is rendered with non-breaking spaces (U+00A0) so it survives `String#strip` and similar transforms. Set to `false` to use regular ASCII spaces instead, which makes terminal selections (e.g. tmux `shift+v`) yank a shell-safe string — non-breaking spaces are not treated as whitespace by most shells and otherwise get glued to the last argument of a pasted command.
 - `:pager` turns on or off pagination using `less` or closest available substitute.
 - `:preserve_linebreaks` determines whether hard breaks within paragraphs are preserved. When converting to HTML, most Markdown processors will cause consecutive lines to be merged together, which is the default behavior for `mdless`. Turning this option on will cause lines to remain hard wrapped.
 - `:syntax_highlight` will turn on/off syntax highlighting of code blocks (requires Pygments)

data/lib/mdless/console.rb

@@ -59,9 +59,16 @@ module Redcarpet
       end
 
       def code_bg(input, width)
+        # NOTE: trailing reset is `xc` (\e[0;37m), not bare `x` (\e[0m).
+        # clean_escapes in converter.rb strips every bare \e[0m from the final
+        # output, so a bare-reset trailer would leak the code-block bg into the
+        # rest of the line (terminals with bce extend bg to the right edge).
+        # \e[0;37m embeds the same `0` reset parameter alongside a fg set, so
+        # it survives clean_escapes and still clears the bg before the newline.
+        pad_char = MDLess.options[:nbsp_padding] ? "\u00A0" : ' '
         input.split(/\n/).map do |line|
-          tail = line.uncolor.length < width ? "\u00A0" * (width - line.uncolor.length) : ''
-          "#{x}#{line}#{tail}#{x}"
+          tail = line.uncolor.length < width ? pad_char * (width - line.uncolor.length) : ''
+          "#{x}#{line}#{tail}#{xc}"
         end.join("\n")
       end
 
@@ -122,19 +129,26 @@ module Redcarpet
                                        stdin_data: code_block)
 
             if s.success?
+              # NOTE: do NOT append xc/\n after blackout. blackout's `$` regex
+              # injects the bg-color escape at the end of every line; anything
+              # appended after that becomes part of the last line when code_bg
+              # later splits on \n, and a trailing xc there resets the bg so
+              # the last line's right-padding renders without the block bg.
+              # code_bg now emits its own per-line xc trailer instead.
               hilite = xc + hilite.split(/\n/).map do |l|
                 [
                   color('code_block marker'),
                   MDLess.theme['code_block']['character'],
                   "#{color('code_block bg')}#{l}#{xc}"
                 ].join
-              end.join("\n").blackout(MDLess.theme['code_block']['bg']) + "#{xc}\n"
+              end.join("\n").blackout(MDLess.theme['code_block']['bg'])
             end
           rescue StandardError => e
             MDLess.log.error(e)
             hilite = code_block
           end
         else
+          # See note above re: dropping the trailing xc/\n.
           hilite = code_block.split(/\n/).map do |line|
             [
               color('code_block marker'),
@@ -143,7 +157,7 @@ module Redcarpet
               line,
               xc
             ].join
-          end.join("\n").blackout(MDLess.theme['code_block']['bg']) + "#{xc}\n"
+          end.join("\n").blackout(MDLess.theme['code_block']['bg'])
         end
 
         top_border = if language.nil? || language.empty?
@@ -195,7 +209,11 @@ module Redcarpet
       end
 
       def block_code(code, language)
-        "\n\n#{hilite_code(code, language)}#{xc}\n\n"
+        # Wrap in <<codeblock>>...<</codeblock>> markers so postprocess can
+        # skip the backslash-escape strip inside code-block content (per the
+        # CommonMark spec, backslash-escapes do not apply inside code blocks).
+        # The markers are removed in postprocess after the strip pass.
+        "\n\n<<codeblock>>#{hilite_code(code, language)}#{xc}<</codeblock>>\n\n"
       end
 
       def block_quote(quote)
@@ -744,6 +762,7 @@ module Redcarpet
         input = text.dup
         input.clean_empty_lines!
         MDLess.meta = {}
+        pad_char = MDLess.options[:nbsp_padding] ? "\u00A0" : ' '
         first_line = input.split("\n").first
         if first_line =~ /(?i-m)^---[ \t]*?$/
           MDLess.log.info('Found YAML')
@@ -773,7 +792,7 @@ module Redcarpet
                 line = "#{color('metadata marker')}% #{color('metadata color')}#{line}"
               end
               if (longest - line.uncolor.strip.length).positive?
-                line += "\u00A0" * (longest - line.uncolor.strip.length)
+                line += pad_char * (longest - line.uncolor.strip.length)
               end
               line + xc
             end.join("\n") + "#{xc}\n"
@@ -799,7 +818,7 @@ module Redcarpet
               end
               line = "#{color('metadata marker')}%#{color('metadata color')}#{line}"
               if (longest - line.uncolor.strip.length).positive?
-                line += "\u00A0" * (longest - line.uncolor.strip.length)
+                line += pad_char * (longest - line.uncolor.strip.length)
               end
               line + xc
             end.join("\n") + "#{xc}\n"
@@ -1144,8 +1163,19 @@ module Redcarpet
           end.join("\n")
           input = "#{input}\n\n#{footnotes}"
         end
-        # escaped characters
-        input.gsub!(/\\(\S)/, '\1')
+        # Escaped characters: strip backslash-escapes per CommonMark spec
+        # (https://spec.commonmark.org/0.31.2/#backslash-escapes), but only
+        # for the ASCII punctuation set the spec actually recognizes, and
+        # only on non-code-block content. block_code wraps its output in
+        # <<codeblock>>...<</codeblock>> markers so we can isolate those
+        # regions here. The previous `\\(\S)` form ate every backslash-
+        # followed-by-non-space, including `\n \t \s \S \d \w \1 \2 ...`
+        # inside code blocks, which shifted padding-aligned right edges
+        # left by N chars per stripped backslash.
+        input = input.split(%r{(<<codeblock>>.*?<</codeblock>>)}m).map.with_index do |seg, i|
+          i.odd? ? seg : seg.gsub(/\\([!"\#$%&'()*+,\-.\/:;<=>?@\[\\\]^_`{|}~])/, '\1')
+        end.join
+        input.gsub!(%r{<</?codeblock>>}, '')
         # equations
         input = fix_equations(input)
         # misc html

data/lib/mdless/converter.rb

@@ -196,6 +196,13 @@ module CLIMarkdown
           MDLess.options[:mmd_metadata] = opt
         end
 
+        default(:nbsp_padding, true)
+        opts.on("--[no-]nbsp-padding",
+                "Pad code blocks and metadata headers with non-breaking spaces" \
+                " (default true; disable for clipboard-safe yank+paste in terminal multiplexers)") do |opt|
+          MDLess.options[:nbsp_padding] = opt
+        end
+
         default(:syntax_higlight, false)
         opts.on("--[no-]syntax", "Syntax highlight code blocks") do |opt|
           MDLess.options[:syntax_higlight] = opt

data/lib/mdless/string.rb

@@ -57,6 +57,7 @@ class ::String
     input = dup
     input.clean_empty_lines!
     MDLess.meta = {}
+    pad_char = MDLess.options[:nbsp_padding] ? "\u00A0" : ' '
 
     in_yaml = false
     first_line = input.split("\n").first
@@ -79,7 +80,7 @@ class ::String
             line = "#{color('metadata marker')}%#{color('metadata color')}#{line}#{xc}"
           end
 
-          line += "\u00A0" * (longest - line.uncolor.strip.length) if (longest - line.uncolor.strip.length).positive?
+          line += pad_char * (longest - line.uncolor.strip.length) if (longest - line.uncolor.strip.length).positive?
           line + xc
         end.join("\n") + "#{xc}\n"
       end
@@ -100,9 +101,9 @@ class ::String
           value = parts[2].strip
           MDLess.meta[key] = value
           line = "#{color('metadata color')}#{line}#{xc}"
-          line += "\u00A0" * (longest - line.uncolor.strip.length) if (longest - line.uncolor.strip.length).positive?
+          line += pad_char * (longest - line.uncolor.strip.length) if (longest - line.uncolor.strip.length).positive?
           line + xc
-        end.join("\n") + "#{"\u00A0" * longest}#{xc}\n"
+        end.join("\n") + "#{pad_char * longest}#{xc}\n"
       end
     end
 

data/lib/mdless/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CLIMarkdown
-  VERSION = '2.1.64'
+  VERSION = '2.1.66'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mdless
 version: !ruby/object:Gem::Version
-  version: 2.1.64
+  version: 2.1.66
 platform: ruby
 authors:
 - Brett Terpstra
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-12 00:00:00.000000000 Z
+date: 2026-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redcarpet