markdownr 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c3e87f1a091aae321ef6ed25f1780ffc034278328d6432762d7126947029cf63
+  data.tar.gz: aced5406c9386d7f09f46484bec59c4e6ef4df7dab40d0fa497ed37c1a4da83c
+SHA512:
+  metadata.gz: 923029aa7a8065c52983debabd69ae1e411a24cf8168b13629457ff8f0dbb4ceafc93db7b4755d73cbb2f443469200534e06b3316901ef0a03cf70f157551ef1
+  data.tar.gz: 533e4b984b363692a3fa7a8269818d246cbd5f5846a92103f3eb9b250e57376bcf030953fbc71496502190a93d7951bebbc9610271874c1ec4f25e2ef78426d1

data/bin/markdownr

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+require "optparse"
+require_relative "../lib/markdown_server"
+
+options = { port: 4567, bind: "0.0.0.0" }
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: markdownr [options] [directory]"
+
+  opts.on("-p", "--port PORT", Integer, "Port to listen on (default: 4567)") do |p|
+    options[:port] = p
+  end
+
+  opts.on("-b", "--bind ADDRESS", "Address to bind to (default: 0.0.0.0)") do |b|
+    options[:bind] = b
+  end
+
+  opts.on("-t", "--title TITLE", "Custom page title") do |t|
+    options[:title] = t
+  end
+
+  opts.on("-v", "--version", "Show version") do
+    puts "markdownr #{MarkdownServer::VERSION}"
+    exit
+  end
+end.parse!
+
+dir = ARGV.first || "."
+dir = File.expand_path(dir)
+
+unless File.directory?(dir)
+  $stderr.puts "Error: #{dir} is not a directory"
+  exit 1
+end
+
+MarkdownServer::App.set :root_dir, dir
+MarkdownServer::App.set :custom_title, options[:title]
+MarkdownServer::App.set :port, options[:port]
+MarkdownServer::App.set :bind, options[:bind]
+
+puts "Serving #{dir} on http://#{options[:bind]}:#{options[:port]}/"
+MarkdownServer::App.run!

data/lib/markdown_server/app.rb

@@ -0,0 +1,331 @@
+require "sinatra/base"
+require "kramdown"
+require "kramdown-parser-gfm"
+require "rouge"
+require "yaml"
+require "json"
+require "uri"
+require "cgi"
+require "pathname"
+
+module MarkdownServer
+  class App < Sinatra::Base
+    EXCLUDED = %w[.git .obsidian __pycache__ .DS_Store node_modules .claude].freeze
+
+    set :views, File.expand_path("../../views", __dir__)
+
+    configure do
+      set :root_dir, Dir.pwd
+      set :custom_title, nil
+      set :show_exceptions, false
+    end
+
+    helpers do
+      def root_dir
+        settings.root_dir
+      end
+
+      def h(text)
+        CGI.escapeHTML(text.to_s)
+      end
+
+      def encode_path_component(str)
+        URI.encode_www_form_component(str).gsub("+", "%20")
+      end
+
+      def safe_path(requested)
+        base = File.realpath(root_dir)
+        full = File.join(base, requested)
+
+        begin
+          real = File.realpath(full)
+        rescue Errno::ENOENT
+          halt 404, erb(:layout) { "<h1>Not Found</h1><p>#{h(requested)}</p>" }
+        end
+
+        unless real.start_with?(base)
+          halt 403, erb(:layout) { "<h1>Forbidden</h1>" }
+        end
+
+        relative = real.sub("#{base}/", "")
+        first_segment = relative.split("/").first
+        if EXCLUDED.include?(first_segment) || first_segment&.start_with?(".")
+          halt 403, erb(:layout) { "<h1>Forbidden</h1>" }
+        end
+
+        real
+      end
+
+      def format_size(bytes)
+        if bytes < 1024
+          "#{bytes} B"
+        elsif bytes < 1024 * 1024
+          "%.1f KB" % (bytes / 1024.0)
+        else
+          "%.1f MB" % (bytes / (1024.0 * 1024))
+        end
+      end
+
+      def format_date(time)
+        time.strftime("%Y-%m-%d %H:%M")
+      end
+
+      def icon_for(entry_name, is_dir)
+        if is_dir
+          "\u{1F4C1}"
+        else
+          ext = File.extname(entry_name).downcase
+          case ext
+          when ".md" then "\u{1F4DD}"
+          when ".pdf" then "\u{1F4D5}"
+          when ".json" then "\u{1F4CB}"
+          when ".py" then "\u{1F40D}"
+          when ".rb" then "\u{1F48E}"
+          when ".csv" then "\u{1F4CA}"
+          when ".epub" then "\u{1F4D6}"
+          else "\u{1F4C4}"
+          end
+        end
+      end
+
+      def breadcrumbs(path)
+        parts = path.split("/").reject(&:empty?)
+        crumbs = [{ name: "home", href: "/browse/" }]
+        parts.each_with_index do |part, i|
+          href = "/browse/" + parts[0..i].map { |p| encode_path_component(p) }.join("/") + "/"
+          crumbs << { name: part, href: href }
+        end
+        crumbs
+      end
+
+      def parse_frontmatter(content)
+        if content =~ /\A---\s*\n(.*?\n)---\s*\n(.*)/m
+          begin
+            meta = YAML.safe_load($1, permitted_classes: [Date, Time])
+            body = $2
+            [meta, body]
+          rescue => e
+            [nil, content]
+          end
+        else
+          [nil, content]
+        end
+      end
+
+      def render_markdown(text)
+        html = Kramdown::Document.new(
+          text,
+          input: "GFM",
+          syntax_highlighter: "rouge",
+          syntax_highlighter_opts: { default_lang: "text" },
+          hard_wrap: false
+        ).to_html
+
+        html.gsub(/\[\[([^\]]+)\]\]/) do
+          link_text = $1
+          resolved = resolve_wiki_link(link_text)
+          if resolved
+            %(<a class="wiki-link" href="/browse/#{encode_path_component(resolved).gsub('%2F', '/')}">#{h(link_text)}</a>)
+          else
+            %(<span class="wiki-link broken">#{h(link_text)}</span>)
+          end
+        end
+      end
+
+      def resolve_wiki_link(name)
+        filename = "#{name}.md"
+
+        # Search all subdirectories
+        Dir.glob(File.join(root_dir, "**", filename)).each do |path|
+          real = File.realpath(path)
+          base = File.realpath(root_dir)
+          relative = real.sub("#{base}/", "")
+          first_segment = relative.split("/").first
+          next if EXCLUDED.include?(first_segment) || first_segment&.start_with?(".")
+          return relative
+        end
+
+        # Try root level
+        path = File.join(root_dir, filename)
+        return filename if File.exist?(path)
+
+        nil
+      end
+
+      def render_frontmatter_value(value)
+        case value
+        when Array
+          value.map { |v| %(<span class="tag">#{h(v)}</span>) }.join(" ")
+        when String
+          if value =~ /\Ahttps?:\/\//
+            %(<a href="#{h(value)}" target="_blank" rel="noopener">#{h(value)}</a>)
+          elsif value.length > 120
+            render_markdown(value)
+          else
+            h(value)
+          end
+        when Numeric, TrueClass, FalseClass
+          h(value.to_s)
+        when NilClass
+          %(<span class="empty">—</span>)
+        else
+          h(value.to_s)
+        end
+      end
+
+      def syntax_highlight(code, language)
+        formatter = Rouge::Formatters::HTML.new
+        lexer = Rouge::Lexer.find_fancy(language) || Rouge::Lexers::PlainText.new
+        formatter.format(lexer.lex(code))
+      end
+
+      def extract_toc(html)
+        headings = []
+        html.scan(/<h([1-6])\s[^>]*id="([^"]*)"[^>]*>(.*?)<\/h\1>/mi) do |level, id, text|
+          clean_text = text.gsub(/<[^>]+>/, "").strip
+          headings << { level: level.to_i, id: id, text: clean_text }
+        end
+        headings
+      end
+
+      def dir_title
+        return settings.custom_title if settings.respond_to?(:custom_title) && settings.custom_title
+        File.basename(root_dir).gsub(/[-_]/, " ").gsub(/\b\w/, &:upcase)
+      end
+    end
+
+    # Routes
+
+    get "/" do
+      redirect "/browse/"
+    end
+
+    get "/browse/?*" do
+      requested = params["splat"].first.to_s
+      requested = requested.chomp("/")
+
+      if requested.empty?
+        real_path = File.realpath(root_dir)
+      else
+        real_path = safe_path(requested)
+      end
+
+      if File.directory?(real_path)
+        render_directory(real_path, requested)
+      else
+        render_file(real_path, requested)
+      end
+    end
+
+    get "/download/*" do
+      requested = params["splat"].first.to_s
+      real_path = safe_path(requested)
+      halt 404 unless File.file?(real_path)
+
+      send_file real_path, disposition: "attachment"
+    end
+
+    private
+
+    def render_directory(real_path, relative_path)
+      entries = Dir.entries(real_path).reject do |e|
+        e.start_with?(".") || EXCLUDED.include?(e)
+      end
+
+      items = entries.map do |name|
+        full = File.join(real_path, name)
+        stat = File.stat(full) rescue next
+        btime = stat.respond_to?(:birthtime) ? stat.birthtime : stat.mtime rescue stat.mtime
+        {
+          name: name,
+          is_dir: stat.directory?,
+          size: stat.directory? ? nil : stat.size,
+          mtime: stat.mtime,
+          ctime: btime,
+          href: "/browse/" + (relative_path.empty? ? "" : relative_path + "/") +
+                encode_path_component(name) + (stat.directory? ? "/" : "")
+        }
+      end.compact
+
+      @sort = %w[name mtime ctime].include?(params[:sort]) ? params[:sort] : "mtime"
+      @order = %w[asc desc].include?(params[:order]) ? params[:order] : nil
+      # Default order: name=asc, times=desc
+      effective_order = @order || (@sort == "name" ? "asc" : "desc")
+      @order_display = effective_order
+
+      sort_items = ->(list) do
+        sorted = case @sort
+                 when "name"  then list.sort_by { |i| i[:name].downcase }
+                 when "ctime" then list.sort_by { |i| i[:ctime].to_f }
+                 else              list.sort_by { |i| i[:mtime].to_f }
+                 end
+        effective_order == "desc" ? sorted.reverse : sorted
+      end
+
+      dirs = sort_items.call(items.select { |i| i[:is_dir] })
+      files = sort_items.call(items.reject { |i| i[:is_dir] })
+
+      @items = dirs + files
+      @path = relative_path
+      @crumbs = breadcrumbs(relative_path)
+      @title = relative_path.empty? ? dir_title : File.basename(relative_path)
+      erb :directory
+    end
+
+    def render_file(real_path, relative_path)
+      ext = File.extname(real_path).downcase
+      @crumbs = breadcrumbs(relative_path)
+      @title = File.basename(real_path)
+      @download_href = "/download/" + relative_path.split("/").map { |p| encode_path_component(p) }.join("/")
+
+      case ext
+      when ".md"
+        content = File.read(real_path, encoding: "utf-8")
+        @meta, body = parse_frontmatter(content)
+        @content = render_markdown(body)
+        @toc = extract_toc(@content)
+        @has_toc = @toc.length > 1
+        erb :markdown
+
+      when ".json"
+        raw = File.read(real_path, encoding: "utf-8")
+        begin
+          data = JSON.parse(raw)
+          yaml_str = YAML.dump(data)
+          @code = syntax_highlight(yaml_str, "yaml")
+          @language = "yaml"
+        rescue JSON::ParserError
+          @code = syntax_highlight(raw, "json")
+          @language = "json"
+        end
+        erb :raw
+
+      when ".pdf"
+        send_file real_path, type: "application/pdf", disposition: "inline"
+
+      when ".epub"
+        redirect @download_href
+
+      else
+        content = File.read(real_path, encoding: "utf-8") rescue nil
+        if content.nil? || content.encoding == Encoding::BINARY || !content.valid_encoding?
+          send_file real_path, disposition: "inline"
+        else
+          lang = case ext
+                 when ".py" then "python"
+                 when ".rb" then "ruby"
+                 when ".csv" then "text"
+                 when ".sh" then "bash"
+                 when ".yaml", ".yml" then "yaml"
+                 when ".html", ".erb" then "html"
+                 when ".js" then "javascript"
+                 else "text"
+                 end
+          @code = syntax_highlight(content, lang)
+          @language = lang
+          erb :raw
+        end
+      end
+    end
+  end
+end

data/lib/markdown_server/version.rb

@@ -0,0 +1,3 @@
+module MarkdownServer
+  VERSION = "0.1.0"
+end

data/lib/markdown_server.rb

@@ -0,0 +1,2 @@
+require_relative "markdown_server/version"
+require_relative "markdown_server/app"

data/views/directory.erb

@@ -0,0 +1,77 @@
+<script>
+(function() {
+  var p = new URLSearchParams(window.location.search);
+  if (!p.has('sort')) {
+    try {
+      var pref = JSON.parse(localStorage.getItem('mdSortPref'));
+      if (pref && pref.sort) {
+        var url = new URL(window.location);
+        url.searchParams.set('sort', pref.sort);
+        if (pref.order) url.searchParams.set('order', pref.order);
+        window.location.replace(url.toString());
+      }
+    } catch(e) {}
+  }
+})();
+</script>
+
+<h1 class="page-title"><%= h(@title) %></h1>
+
+<div class="dir-header">
+  <div class="dir-count">
+    <%= @items.count { |i| i[:is_dir] } %> folders, <%= @items.count { |i| !i[:is_dir] } %> files
+  </div>
+  <div class="sort-controls">
+    <%
+      sort_options = [
+        ["name",  "Name"],
+        ["mtime", "Modified"],
+        ["ctime", "Created"],
+      ]
+      base = request.path
+    %>
+    <% sort_options.each_with_index do |(key, label), i| %>
+      <% active = @sort == key %>
+      <% if active %>
+        <%
+          # Clicking active sort reverses direction
+          default_order = key == "name" ? "asc" : "desc"
+          toggled = @order_display == "asc" ? "desc" : "asc"
+          next_order = @order ? toggled : (default_order == "asc" ? "desc" : "asc")
+          arrow = @order_display == "asc" ? "\u25B2" : "\u25BC"
+        %>
+        <a href="<%= base %>?sort=<%= key %>&order=<%= next_order %>" class="sort-active"><%= label %> <span class="sort-arrow"><%= arrow %></span></a>
+      <% else %>
+        <a href="<%= base %>?sort=<%= key %>"><%= label %></a>
+      <% end %>
+    <% end %>
+  </div>
+</div>
+
+<ul class="dir-listing">
+  <% @items.each do |item| %>
+    <li>
+      <a href="<%= item[:href] %>">
+        <span class="icon"><%= icon_for(item[:name], item[:is_dir]) %></span>
+        <span class="name"><%= h(item[:name]) %><%= "/" if item[:is_dir] %></span>
+        <span class="meta">
+          <% unless item[:is_dir] %>
+            <span class="size"><%= format_size(item[:size]) %></span>
+            <span class="date"><%= format_date(item[:mtime]) %></span>
+          <% end %>
+        </span>
+      </a>
+    </li>
+  <% end %>
+</ul>
+
+<script>
+document.querySelectorAll('.sort-controls a').forEach(function(link) {
+  link.addEventListener('click', function() {
+    var url = new URL(link.href);
+    var sort = url.searchParams.get('sort');
+    var order = url.searchParams.get('order') || (sort === 'name' ? 'asc' : 'desc');
+    localStorage.setItem('mdSortPref', JSON.stringify({sort: sort, order: order}));
+  });
+});
+</script>

data/views/layout.erb

@@ -0,0 +1,510 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title><%= h(@title || dir_title) %></title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; }
+
+    body {
+      font-family: Georgia, "Times New Roman", serif;
+      background: #faf8f4;
+      color: #2c2c2c;
+      margin: 0;
+      padding: 0;
+      line-height: 1.7;
+    }
+
+    .container {
+      max-width: 900px;
+      margin: 0 auto;
+      padding: 1.5rem 2rem 3rem;
+    }
+    .container.has-toc {
+      max-width: 1150px;
+    }
+
+    /* Breadcrumbs */
+    .breadcrumbs {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.85rem;
+      margin-bottom: 1.5rem;
+      color: #888;
+    }
+    .breadcrumbs a {
+      color: #8b6914;
+      text-decoration: none;
+    }
+    .breadcrumbs a:hover { text-decoration: underline; }
+    .breadcrumbs .sep { margin: 0 0.4rem; color: #ccc; }
+
+    /* Page title */
+    h1.page-title {
+      font-size: 1.6rem;
+      margin: 0 0 1.2rem;
+      color: #3a3a3a;
+      border-bottom: 2px solid #d4b96a;
+      padding-bottom: 0.5rem;
+    }
+
+    /* Directory listing */
+    .dir-listing {
+      list-style: none;
+      padding: 0;
+      margin: 0;
+    }
+    .dir-listing li {
+      border-bottom: 1px solid #eee;
+    }
+    .dir-listing a {
+      display: flex;
+      align-items: center;
+      padding: 0.6rem 0.4rem;
+      text-decoration: none;
+      color: #2c2c2c;
+      transition: background 0.15s;
+    }
+    .dir-listing a:hover {
+      background: #f0ece3;
+    }
+    .dir-listing .icon {
+      margin-right: 0.6rem;
+      font-size: 1.1rem;
+      flex-shrink: 0;
+    }
+    .dir-listing .name {
+      flex: 1;
+      font-size: 0.95rem;
+      color: #8b6914;
+      word-break: break-word;
+    }
+    .dir-listing .meta {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.75rem;
+      color: #aaa;
+      text-align: right;
+      white-space: nowrap;
+      margin-left: 1rem;
+    }
+    .dir-listing .meta .size {
+      margin-right: 1rem;
+    }
+
+    /* Frontmatter */
+    details.frontmatter {
+      margin-bottom: 1.5rem;
+      border: 1px solid #e0d8c8;
+      border-radius: 6px;
+      background: #fdfcf9;
+    }
+    details.frontmatter summary {
+      cursor: pointer;
+      padding: 0.6rem 1rem;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.85rem;
+      font-weight: 600;
+      color: #8b6914;
+      background: #f5f0e4;
+      border-radius: 6px 6px 0 0;
+      user-select: none;
+    }
+    details.frontmatter[open] summary {
+      border-bottom: 1px solid #e0d8c8;
+    }
+    .meta-table {
+      width: 100%;
+      border-collapse: collapse;
+      font-size: 0.88rem;
+    }
+    .meta-table th {
+      text-align: left;
+      vertical-align: top;
+      padding: 0.4rem 1rem;
+      width: 140px;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-weight: 600;
+      color: #666;
+      white-space: nowrap;
+    }
+    .meta-table td {
+      padding: 0.4rem 1rem;
+      vertical-align: top;
+      word-break: break-word;
+    }
+    .meta-table tr:nth-child(even) { background: #faf8f2; }
+
+    .tag {
+      display: inline-block;
+      background: #e8dfc8;
+      color: #5a4a1e;
+      padding: 0.15rem 0.55rem;
+      border-radius: 3px;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.8rem;
+      margin: 0.1rem 0.2rem;
+    }
+
+    .empty { color: #ccc; }
+
+    /* Markdown content */
+    .md-content {
+      line-height: 1.8;
+    }
+    .md-content h1 { font-size: 1.5rem; margin: 1.5rem 0 0.8rem; color: #3a3a3a; }
+    .md-content h2 {
+      font-size: 1.25rem;
+      margin: 1.8rem 0 0.6rem;
+      color: #3a3a3a;
+      border-bottom: 1px solid #e0d8c8;
+      padding-bottom: 0.3rem;
+    }
+    .md-content h3 { font-size: 1.1rem; margin: 1.4rem 0 0.5rem; color: #555; }
+
+    .md-content blockquote {
+      border-left: 4px solid #d4b96a;
+      margin: 1rem 0;
+      padding: 0.5rem 1.2rem;
+      background: #fdfcf6;
+      color: #4a4a4a;
+      font-style: italic;
+    }
+    .md-content blockquote p {
+      white-space: pre-wrap;
+      margin: 0;
+    }
+
+    .md-content a {
+      color: #8b6914;
+      text-decoration: none;
+      border-bottom: 1px solid #d4b96a;
+    }
+    .md-content a:hover { border-bottom-color: #8b6914; }
+
+    .md-content code {
+      font-family: "SF Mono", Menlo, Consolas, monospace;
+      font-size: 0.88em;
+      background: #f0ece3;
+      padding: 0.15em 0.4em;
+      border-radius: 3px;
+    }
+    .md-content pre {
+      background: #2d2d2d;
+      color: #f0f0f0;
+      padding: 1rem 1.2rem;
+      border-radius: 6px;
+      overflow-x: auto;
+      font-size: 0.85rem;
+      line-height: 1.5;
+    }
+    .md-content pre code {
+      background: none;
+      padding: 0;
+      color: inherit;
+    }
+
+    .md-content hr {
+      border: none;
+      border-top: 1px solid #e0d8c8;
+      margin: 2rem 0;
+    }
+
+    .md-content ul, .md-content ol { padding-left: 1.5rem; }
+    .md-content li { margin-bottom: 0.3rem; }
+
+    /* Tables */
+    .table-wrap {
+      overflow-x: auto;
+      margin: 1rem 0;
+      -webkit-overflow-scrolling: touch;
+    }
+    .md-content table {
+      border-collapse: collapse;
+      width: 100%;
+      font-size: 0.88rem;
+      min-width: 500px;
+    }
+    .md-content th, .md-content td {
+      border: 1px solid #ddd;
+      padding: 0.45rem 0.7rem;
+      text-align: left;
+      vertical-align: top;
+    }
+    .md-content th {
+      background: #f5f0e4;
+      font-weight: 600;
+      color: #555;
+      white-space: nowrap;
+    }
+    .md-content tr:nth-child(even) { background: #fdfcf9; }
+
+    /* Wiki links */
+    a.wiki-link {
+      color: #6a8e3e;
+      border-bottom: 1px dashed #6a8e3e;
+    }
+    span.wiki-link.broken {
+      color: #c44;
+      border-bottom: 1px dashed #c44;
+    }
+
+    /* Raw/code view */
+    .raw-view {
+      background: #2d2d2d;
+      color: #f0f0f0;
+      padding: 1.2rem 1.5rem;
+      border-radius: 6px;
+      overflow-x: auto;
+      font-family: "SF Mono", Menlo, Consolas, monospace;
+      font-size: 0.85rem;
+      line-height: 1.5;
+    }
+
+    /* Download link */
+    .toolbar {
+      display: flex;
+      gap: 1rem;
+      align-items: center;
+      margin-bottom: 1rem;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.85rem;
+    }
+    .toolbar a {
+      color: #8b6914;
+      text-decoration: none;
+      border-bottom: 1px solid #d4b96a;
+    }
+    .toolbar a:hover { border-bottom-color: #8b6914; }
+
+    /* Directory header */
+    .dir-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: baseline;
+      margin-bottom: 1rem;
+    }
+    .dir-count {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.8rem;
+      color: #aaa;
+    }
+    .sort-controls {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.75rem;
+      display: flex;
+      gap: 0.6rem;
+    }
+    .sort-controls a {
+      color: #bbb;
+      text-decoration: none;
+      transition: color 0.15s;
+    }
+    .sort-controls a:hover { color: #8b6914; }
+    .sort-controls a.sort-active {
+      color: #8b6914;
+      font-weight: 600;
+    }
+    .sort-arrow { font-size: 0.6rem; }
+
+    /* Rouge syntax highlighting (Monokai-inspired) */
+    .highlight .k, .highlight .kd, .highlight .kn, .highlight .kp,
+    .highlight .kr, .highlight .kt { color: #66d9ef; }
+    .highlight .s, .highlight .s1, .highlight .s2, .highlight .sb,
+    .highlight .sc, .highlight .sd, .highlight .sh, .highlight .sx { color: #e6db74; }
+    .highlight .c, .highlight .c1, .highlight .cm, .highlight .cs { color: #75715e; font-style: italic; }
+    .highlight .na { color: #a6e22e; }
+    .highlight .nf, .highlight .nb { color: #a6e22e; }
+    .highlight .nn, .highlight .nc { color: #66d9ef; }
+    .highlight .no { color: #ae81ff; }
+    .highlight .mi, .highlight .mf, .highlight .mh, .highlight .mo { color: #ae81ff; }
+    .highlight .o, .highlight .ow { color: #f92672; }
+    .highlight .p { color: #f0f0f0; }
+    .highlight .gi { color: #a6e22e; }
+    .highlight .gd { color: #f92672; }
+
+    /* TOC sidebar */
+    .page-with-toc {
+      display: flex;
+      gap: 2rem;
+      align-items: flex-start;
+    }
+    .toc-sidebar {
+      width: 220px;
+      flex-shrink: 0;
+      position: sticky;
+      top: 1rem;
+      max-height: calc(100vh - 2rem);
+      overflow-y: auto;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.8rem;
+      line-height: 1.4;
+      border-right: 1px solid #e0d8c8;
+      padding-right: 1rem;
+    }
+    .toc-sidebar .toc-title {
+      font-weight: 600;
+      color: #8b6914;
+      margin-bottom: 0.6rem;
+      font-size: 0.75rem;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+    }
+    .toc-sidebar ul {
+      list-style: none;
+      padding: 0;
+      margin: 0;
+    }
+    .toc-sidebar li {
+      margin-bottom: 0.25rem;
+    }
+    .toc-sidebar a {
+      color: #666;
+      text-decoration: none;
+      display: block;
+      padding: 0.15rem 0;
+      border-left: 2px solid transparent;
+      padding-left: 0.5rem;
+      transition: color 0.15s, border-color 0.15s;
+    }
+    .toc-sidebar a:hover {
+      color: #8b6914;
+      border-left-color: #d4b96a;
+    }
+    .toc-sidebar a.active {
+      color: #8b6914;
+      border-left-color: #8b6914;
+      font-weight: 600;
+    }
+    .toc-sidebar .toc-h3 { padding-left: 1.1rem; font-size: 0.76rem; }
+    .toc-sidebar .toc-h4 { padding-left: 1.7rem; font-size: 0.73rem; }
+    .page-with-toc .page-main {
+      flex: 1;
+      min-width: 0;
+    }
+
+    /* Mobile TOC (replaces sidebar) */
+    .toc-mobile {
+      display: none;
+      margin-bottom: 1rem;
+      border: 1px solid #e0d8c8;
+      border-radius: 6px;
+      background: #fdfcf9;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      font-size: 0.82rem;
+    }
+    .toc-mobile summary {
+      cursor: pointer;
+      padding: 0.5rem 0.8rem;
+      font-weight: 600;
+      color: #8b6914;
+      font-size: 0.8rem;
+      user-select: none;
+    }
+    .toc-mobile ul {
+      list-style: none;
+      padding: 0 0.8rem 0.5rem;
+      margin: 0;
+    }
+    .toc-mobile li { margin-bottom: 0.2rem; }
+    .toc-mobile a {
+      color: #666;
+      text-decoration: none;
+      padding: 0.2rem 0;
+      display: block;
+    }
+    .toc-mobile a:hover { color: #8b6914; }
+    .toc-mobile .toc-h3 { padding-left: 0.8rem; }
+    .toc-mobile .toc-h4 { padding-left: 1.4rem; }
+
+    /* Responsive */
+    @media (max-width: 768px) {
+      .container { padding: 1rem; }
+      .container.has-toc { max-width: 900px; }
+      h1.page-title { font-size: 1.3rem; }
+
+      .page-with-toc { display: block; }
+      .toc-sidebar { display: none; }
+      .toc-mobile { display: block; }
+
+      .meta-table th, .meta-table td {
+        display: block;
+        width: 100%;
+        padding: 0.2rem 0.8rem;
+      }
+      .meta-table th {
+        padding-top: 0.5rem;
+        padding-bottom: 0;
+      }
+
+      .dir-listing a { padding: 0.8rem 0.4rem; }
+      .dir-listing .name { font-size: 1rem; }
+      .dir-listing .meta .date { display: none; }
+    }
+
+    @media (max-width: 480px) {
+      .container { padding: 0.8rem; }
+      .breadcrumbs { font-size: 0.8rem; }
+      .md-content { font-size: 0.95rem; }
+      .md-content table { font-size: 0.8rem; }
+    }
+  </style>
+</head>
+<body>
+  <div class="container<%= ' has-toc' if @has_toc %>">
+    <% if @crumbs %>
+      <nav class="breadcrumbs">
+        <% @crumbs.each_with_index do |crumb, i| %>
+          <% if i > 0 %><span class="sep">/</span><% end %>
+          <% if i == @crumbs.length - 1 %>
+            <%= h(crumb[:name]) %>
+          <% else %>
+            <a href="<%= crumb[:href] %>"><%= h(crumb[:name]) %></a>
+          <% end %>
+        <% end %>
+      </nav>
+    <% end %>
+
+    <%= yield %>
+  </div>
+
+  <script>
+    // Wrap tables in scrollable containers
+    document.querySelectorAll('.md-content table').forEach(function(table) {
+      if (!table.parentElement.classList.contains('table-wrap')) {
+        var wrapper = document.createElement('div');
+        wrapper.className = 'table-wrap';
+        table.parentNode.insertBefore(wrapper, table);
+        wrapper.appendChild(table);
+      }
+    });
+
+    // TOC scroll spy — highlight the nearest heading
+    (function() {
+      var tocLinks = document.querySelectorAll('.toc-sidebar a');
+      if (!tocLinks.length) return;
+
+      var headings = [];
+      tocLinks.forEach(function(link) {
+        var id = link.getAttribute('href').slice(1);
+        var el = document.getElementById(id);
+        if (el) headings.push({ el: el, link: link });
+      });
+
+      function update() {
+        var scrollY = window.scrollY + 80;
+        var current = null;
+        for (var i = 0; i < headings.length; i++) {
+          if (headings[i].el.offsetTop <= scrollY) {
+            current = headings[i];
+          }
+        }
+        tocLinks.forEach(function(l) { l.classList.remove('active'); });
+        if (current) current.link.classList.add('active');
+      }
+
+      window.addEventListener('scroll', update, { passive: true });
+      update();
+    })();
+  </script>
+</body>
+</html>

data/views/markdown.erb

@@ -0,0 +1,53 @@
+<h1 class="page-title"><%= h(@title) %></h1>
+
+<div class="toolbar">
+  <a href="<%= @download_href %>">Download</a>
+</div>
+
+<% if @has_toc %>
+  <details class="toc-mobile">
+    <summary>Table of Contents</summary>
+    <ul>
+      <% @toc.each do |entry| %>
+        <li class="toc-h<%= entry[:level] %>">
+          <a href="#<%= h(entry[:id]) %>"><%= h(entry[:text]) %></a>
+        </li>
+      <% end %>
+    </ul>
+  </details>
+<% end %>
+
+<div class="<%= @has_toc ? 'page-with-toc' : '' %>">
+  <% if @has_toc %>
+    <nav class="toc-sidebar">
+      <div class="toc-title">Contents</div>
+      <ul>
+        <% @toc.each do |entry| %>
+          <li class="toc-h<%= entry[:level] %>">
+            <a href="#<%= h(entry[:id]) %>"><%= h(entry[:text]) %></a>
+          </li>
+        <% end %>
+      </ul>
+    </nav>
+  <% end %>
+
+  <div class="page-main">
+    <% if @meta && !@meta.empty? %>
+      <details class="frontmatter" open>
+        <summary>Metadata</summary>
+        <table class="meta-table">
+          <% @meta.each do |key, value| %>
+            <tr>
+              <th><%= h(key) %></th>
+              <td><%= render_frontmatter_value(value) %></td>
+            </tr>
+          <% end %>
+        </table>
+      </details>
+    <% end %>
+
+    <div class="md-content" data-file="<%= h(@title) %>">
+      <%= @content %>
+    </div>
+  </div>
+</div>

data/views/raw.erb

@@ -0,0 +1,10 @@
+<h1 class="page-title"><%= h(@title) %></h1>
+
+<div class="toolbar">
+  <a href="<%= @download_href %>">Download</a>
+  <span style="color: #aaa; font-size: 0.8rem;">(<%= h(@language) %>)</span>
+</div>
+
+<div class="raw-view">
+  <pre class="highlight"><%= @code %></pre>
+</div>

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: markdownr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Brian Dunn
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: kramdown-parser-gfm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Serve markdown files from any directory with a clean web interface, syntax
+  highlighting, YAML frontmatter support, and wiki-link resolution.
+executables:
+- markdownr
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/markdownr
+- lib/markdown_server.rb
+- lib/markdown_server/app.rb
+- lib/markdown_server/version.rb
+- views/directory.erb
+- views/layout.erb
+- views/markdown.erb
+- views/raw.erb
+homepage: https://github.com/brianmd/markdown-server
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/brianmd/markdown-server
+  changelog_uri: https://github.com/brianmd/markdown-server/releases
+rdoc_options: []
+require_paths:
+- 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: 3.6.9
+specification_version: 4
+summary: A local markdown file server with directory browsing
+test_files: []