pdftomd-url-tools 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '0801d4241edd492fc5597b3202c544446c66d6f0d87b3b1544c4c1532e72a542'
+  data.tar.gz: abacd143ba7e531983618dbbc1c88e35b99b418d1d7e1272700d12f547b0f363
+SHA512:
+  metadata.gz: f24e401f9b9c4de8e190a750fe8f18217610673c7cec1bdda441c3b055520120d03015786bed1ee3580be13a7d7da7dcd403a525f32fef9593c77f1c016b4f52
+  data.tar.gz: e81544458e91325d17e5ecf0c4ca6c18a0eed2e8b791e421a551c9dc2372b946be95e45e2346812831869bff022a378a5a89cc9c2422b5283aaad1eb3daf7b3d

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangneo276-lgtm
+
+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.md

@@ -0,0 +1,19 @@
+# pdftomd-url-tools
+
+Builds canonical HTTPS URLs for pages that exist on [PDF to MD Converter](https://pdftomd.tools/).
+
+Free in-browser pdf to md tool. Drop a text PDF, preview Markdown, copy or download—files stay on your device. No account required.
+
+Not an official SDK. The helper only accepts paths that are already on the public site. It does not upload files or call the site.
+
+## Examples
+
+- `canonicalUrl("/")` → https://pdftomd.tools/
+- `canonicalUrl("https://pdftomd.tools/md-to-pdf?ref=1#top")` → https://pdftomd.tools/md-to-pdf
+- `pageUrl("pdf-to-md")` → https://pdftomd.tools/pdf-to-md-converter
+- `pageUrl("markdown-to-pdf")` → https://pdftomd.tools/markdown-to-pdf
+- `blogUrl("convert-pdf-tables-to-markdown")` → https://pdftomd.tools/blog/convert-pdf-tables-to-markdown
+
+Source: https://github.com/wangneo276-lgtm/pdftomd-url-tools
+
+License: MIT.

data/ruby/lib/pdftomd_url_tools.rb

@@ -0,0 +1,60 @@
+module PdfToMdUrlTools
+  ORIGIN = 'https://pdftomd.tools'.freeze
+  DESCRIPTION = 'Free in-browser pdf to md tool. Drop a text PDF, preview Markdown, copy or download—files stay on your device. No account required.'.freeze
+  HOST = 'pdftomd.tools'.freeze
+  PATHS = ['/', '/about', '/batch-pdf-to-markdown', '/blog', '/blog/best-document-format-for-chatgpt', '/blog/convert-multiple-pdfs-to-markdown', '/blog/convert-pdf-tables-to-markdown', '/blog/convert-pdf-to-markdown-locally', '/blog/convert-pdf-to-markdown-without-losing-formatting', '/blog/import-pdf-into-obsidian-as-notes', '/blog/markdown-to-pdf-page-breaks', '/blog/print-markdown-to-pdf-with-tables', '/blog/pymupdf4llm-vs-pdfplumber-vs-marker', '/convert-pdf-to-md', '/markdown-to-pdf', '/md-to-pdf', '/pdf-to-markdown-for-llm', '/pdf-to-markdown-obsidian', '/pdf-to-markdown-python', '/pdf-to-md-converter', '/privacy-policy', '/terms-of-service'].freeze
+  PAGES = {'home' => '/', 'pdf-to-md' => '/pdf-to-md-converter', 'convert' => '/convert-pdf-to-md', 'md-to-pdf' => '/md-to-pdf', 'markdown-to-pdf' => '/markdown-to-pdf', 'llm' => '/pdf-to-markdown-for-llm', 'batch' => '/batch-pdf-to-markdown', 'obsidian' => '/pdf-to-markdown-obsidian', 'python' => '/pdf-to-markdown-python', 'about' => '/about', 'privacy' => '/privacy-policy', 'terms' => '/terms-of-service', 'blog' => '/blog'}.freeze
+  BLOGS = {'pymupdf4llm-vs-pdfplumber-vs-marker' => '/blog/pymupdf4llm-vs-pdfplumber-vs-marker', 'import-pdf-into-obsidian-as-notes' => '/blog/import-pdf-into-obsidian-as-notes', 'convert-multiple-pdfs-to-markdown' => '/blog/convert-multiple-pdfs-to-markdown', 'convert-pdf-to-markdown-locally' => '/blog/convert-pdf-to-markdown-locally', 'markdown-to-pdf-page-breaks' => '/blog/markdown-to-pdf-page-breaks', 'best-document-format-for-chatgpt' => '/blog/best-document-format-for-chatgpt', 'convert-pdf-to-markdown-without-losing-formatting' => '/blog/convert-pdf-to-markdown-without-losing-formatting', 'print-markdown-to-pdf-with-tables' => '/blog/print-markdown-to-pdf-with-tables', 'convert-pdf-tables-to-markdown' => '/blog/convert-pdf-tables-to-markdown'}.freeze
+
+  module_function
+
+  def canonical_url(input)
+    raise ArgumentError, 'path required' unless input.is_a?(String)
+    raw = input.strip
+    raise ArgumentError, 'path required' if raw.empty?
+    raise ArgumentError, 'invalid path' if raw.include?('\\') || raw.include?('%')
+    raw = raw.split('#', 2)[0].split('?', 2)[0]
+    lower = raw.downcase
+    if lower.start_with?('https://') || lower.start_with?('http://') || raw.start_with?('//')
+      rest = if lower.start_with?('https://')
+               raw.delete_prefix('https://')
+             elsif lower.start_with?('http://')
+               raw.delete_prefix('http://')
+             else
+               raw.delete_prefix('//')
+             end
+      slash = rest.index('/')
+      hostport = slash.nil? ? rest : rest[0...slash]
+      path = slash.nil? ? '/' : rest[slash..]
+      raise ArgumentError, 'userinfo not allowed' if hostport.include?('@')
+      raise ArgumentError, 'port not allowed' if hostport.include?(':')
+      raise ArgumentError, 'host not allowed' unless hostport.casecmp(HOST).zero?
+    elsif raw.start_with?('/')
+      path = raw
+    else
+      path = '/' + raw
+    end
+    path = path.downcase.gsub(%r{//+}, '/')
+    path.split('/').each do |seg|
+      raise ArgumentError, 'path traversal' if seg == '.' || seg == '..'
+    end
+    path = path.sub(%r{/+$}, '') if path.length > 1
+    path = '/' if path.empty?
+    raise ArgumentError, "unknown path: #{path}" unless PATHS.include?(path)
+    path == '/' ? ORIGIN + '/' : ORIGIN + path
+  end
+
+  def home_url
+    canonical_url('/')
+  end
+
+  def page_url(name)
+    path = PAGES[name] or raise ArgumentError, "unknown page: #{name}"
+    canonical_url(path)
+  end
+
+  def blog_url(slug)
+    path = BLOGS[slug] or raise ArgumentError, "unknown blog: #{slug}"
+    canonical_url(path)
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: pdftomd-url-tools
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- wangneo276-lgtm
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Free in-browser pdf to md tool. Drop a text PDF, preview Markdown, copy
+  or download—files stay on your device. No account required.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- ruby/lib/pdftomd_url_tools.rb
+homepage: https://pdftomd.tools/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://pdftomd.tools/
+  source_code_uri: https://github.com/wangneo276-lgtm/pdftomd-url-tools
+rdoc_options: []
+require_paths:
+- ruby/lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: Free in-browser pdf to md tool. Drop a text PDF, preview Markdown, copy or
+  download—files stay on your device. No account required.
+test_files: []