md-preview 1.0.0__tar.gz

md_preview-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fabio Matricardi
+
+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.

md_preview-1.0.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: md-preview
+Version: 1.0.0
+Summary: Render Markdown files with beautiful Bootstrap styling in your browser
+Author-email: Your Name <your.email@example.com>
+Maintainer-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/fabiomatricardi/markdown-preview-pypi-package
+Project-URL: Documentation, https://github.com/fabiomatricardi/markdown-preview-pypi-package#readme
+Project-URL: Repository, https://github.com/fabiomatricardi/markdown-preview-pypi-package
+Project-URL: Changelog, https://github.com/fabiomatricardi/markdown-preview-pypi-package/releases
+Keywords: markdown,preview,bootstrap,cli,documentation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown>=3.4
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# 🌟 md-preview v2.0
+
+**TRUE BOOTSTRAP RENDERING** - Headers, tables, lists, blockquotes, and code blocks all styled with authentic Bootstrap aesthetics. No more "GitHub CSS + random code theme" mismatch!
+
+![Bootstrap Preview](https://blog.ronin.cloud/content/images/size/w2000/2022/02/markdown.png)  
+*Left: Flatly theme • Right: Darkly theme (full UI consistency)*
+
+## ✨ What Changed in v2.0?
+| Feature | v1.x | v2.0 |
+|---------|------|------|
+| **Headers** | GitHub style | ✅ Bootstrap typography |
+| **Tables** | Basic borders | ✅ `.table-striped` + hover effects |
+| **Blockquotes** | Plain italics | ✅ Bootstrap alerts with icons |
+| **Lists** | Default bullets | ✅ Bootstrap spacing & semantics |
+| **Code Blocks** | Only syntax colored | ✅ Full Bootstrap card styling + copy buttons |
+| **Theme Scope** | Code blocks only | ✅ **ENTIRE PAGE** (true UI kit) |
+| **Responsiveness** | Limited | ✅ Mobile-first Bootstrap grid |
+
+## 🎨 Available Bootstrap Themes
+| Theme | CLI Flag | Type | Best For |
+|-------|----------|------|----------|
+| **Cosmo** | `default` | Light | Friendly documentation |
+| **Flatly** | `flatly` | Light | Modern clean interfaces |
+| **Litera** | `litera` | Light | Readable long-form content |
+| **Darkly** | `darkly` | Dark | Dark mode lovers (vibrant) |
+| **Cyborg** | `cyborg` | Dark | Futuristic/terminal aesthetic |
+| **Superhero** | `superhero` | Dark | Bold presentations |
+
+> 💡 **All themes include**:  
+> - Responsive tables with hover effects  
+> - Blockquotes styled as Bootstrap alerts  
+> - Consistent spacing & typography  
+> - Mobile-optimized layout  
+> - Syntax highlighting that matches theme mode
+
+## 🚀 Usage
+```bash
+# Install updated package
+pip install --upgrade .
+
+# Preview with default Bootstrap theme (Cosmo)
+md-preview README.md
+
+# Use popular Flatly theme (clean light design)
+md-preview report.md --style flatly
+
+# Dark mode workflow
+md-preview notes.md --style darkly
+
+# See ALL elements styled consistently:
+echo '# Header\n\n- List item\n\n| Table | Header |\n|-------|--------|\n| Cell  | Data   |\n\n> Blockquote\n\n```python\nprint("Code")\n```' > test.md
+md-preview test.md --style cyborg
+```
+
+---
+
+# 🌟 md-preview
+
+Render Markdown files with beautiful, modern themes directly in your browser. Zero configuration, instant preview.
+
+<img src='https://user-images.githubusercontent.com/11283502/116907735-a58d7280-ac4a-11eb-8dbd-b905648593f8.png'>  
+*Left: GitHub Light • Right: Dracula Dark (auto-switches with OS theme)*
+
+## ✨ Features
+- 🎨 **5 gorgeous themes**: GitHub (default), Dracula, Catppuccin, Solarized, Atom
+- 🌓 **Automatic dark mode** (respects OS preference)
+- 💡 **Syntax highlighting** with copy buttons on code blocks
+- 📱 **Fully responsive** design (mobile/desktop)
+- 🔒 **No network required after first load** (CDN assets cached by browser)
+- 🚀 **Blazing fast** - pure Python, no heavy dependencies
+- 🌐 **Works everywhere**: Windows, macOS, Linux
+
+
+> what if you have some more features to add?
+
+
+### Tables rendering
+
+#### 🌓 Recommended highlight.js Themes (via `--style` flag):
+| Style Arg | Theme | Vibe |
+|-----------|-------|------|
+| `github` (default) | `github.min.css` | Familiar, professional |
+| `dracula` | `dracula.min.css` | Dark, vibrant, developer favorite |
+| `catppuccin` | `catppuccin-macchiato.min.css` | Modern pastel dark theme |
+| `solarized` | `solarized-dark.min.css` | Classic low-contrast |
+| `atom` | `atom-one-dark.min.css` | Smooth dark UI |
+
+> 💡 **Pro Insight**: `github-markdown-css` **already includes dark mode** via system preference detection. Pair with a dark `highlight.js` theme (e.g., `dracula`) for full dark-mode harmony.
+
+## 📦 Installation
+
+### Option 1: Install as package (recommended)
+```bash
+pip install .
+```
+
+### Example of rendered Python code
+
+```python
+#!/usr/bin/env python3
+"""
+md-preview: Render Markdown files with beautiful themes in your browser
+"""
+import argparse
+import html
+import pathlib
+import sys
+import tempfile
+import webbrowser
+
+try:
+    import markdown
+except ImportError:
+    print("❌ 'markdown' library not found. Install with: pip install markdown", file=sys.stderr)
+    sys.exit(1)
+
+# CORRECTED THEME MAPPINGS (verified CDN paths)
+THEME_MAP = {
+    "github": "github.min",
+    "dracula": "dracula.min",
+    "catppuccin": "catppuccin.min",  # FIXED: was catppuccin-macchiato (invalid CDN path)
+    "solarized": "solarized-dark.min",
+    "atom": "atom-one-dark.min",
+}
+DEFAULT_THEME = "github"
+HIGHLIGHT_VERSION = "11.9.0"  # For cache-busting
+```

md_preview-1.0.0/README.md

@@ -0,0 +1,127 @@
+# 🌟 md-preview v2.0
+
+**TRUE BOOTSTRAP RENDERING** - Headers, tables, lists, blockquotes, and code blocks all styled with authentic Bootstrap aesthetics. No more "GitHub CSS + random code theme" mismatch!
+
+![Bootstrap Preview](https://blog.ronin.cloud/content/images/size/w2000/2022/02/markdown.png)  
+*Left: Flatly theme • Right: Darkly theme (full UI consistency)*
+
+## ✨ What Changed in v2.0?
+| Feature | v1.x | v2.0 |
+|---------|------|------|
+| **Headers** | GitHub style | ✅ Bootstrap typography |
+| **Tables** | Basic borders | ✅ `.table-striped` + hover effects |
+| **Blockquotes** | Plain italics | ✅ Bootstrap alerts with icons |
+| **Lists** | Default bullets | ✅ Bootstrap spacing & semantics |
+| **Code Blocks** | Only syntax colored | ✅ Full Bootstrap card styling + copy buttons |
+| **Theme Scope** | Code blocks only | ✅ **ENTIRE PAGE** (true UI kit) |
+| **Responsiveness** | Limited | ✅ Mobile-first Bootstrap grid |
+
+## 🎨 Available Bootstrap Themes
+| Theme | CLI Flag | Type | Best For |
+|-------|----------|------|----------|
+| **Cosmo** | `default` | Light | Friendly documentation |
+| **Flatly** | `flatly` | Light | Modern clean interfaces |
+| **Litera** | `litera` | Light | Readable long-form content |
+| **Darkly** | `darkly` | Dark | Dark mode lovers (vibrant) |
+| **Cyborg** | `cyborg` | Dark | Futuristic/terminal aesthetic |
+| **Superhero** | `superhero` | Dark | Bold presentations |
+
+> 💡 **All themes include**:  
+> - Responsive tables with hover effects  
+> - Blockquotes styled as Bootstrap alerts  
+> - Consistent spacing & typography  
+> - Mobile-optimized layout  
+> - Syntax highlighting that matches theme mode
+
+## 🚀 Usage
+```bash
+# Install updated package
+pip install --upgrade .
+
+# Preview with default Bootstrap theme (Cosmo)
+md-preview README.md
+
+# Use popular Flatly theme (clean light design)
+md-preview report.md --style flatly
+
+# Dark mode workflow
+md-preview notes.md --style darkly
+
+# See ALL elements styled consistently:
+echo '# Header\n\n- List item\n\n| Table | Header |\n|-------|--------|\n| Cell  | Data   |\n\n> Blockquote\n\n```python\nprint("Code")\n```' > test.md
+md-preview test.md --style cyborg
+```
+
+---
+
+# 🌟 md-preview
+
+Render Markdown files with beautiful, modern themes directly in your browser. Zero configuration, instant preview.
+
+<img src='https://user-images.githubusercontent.com/11283502/116907735-a58d7280-ac4a-11eb-8dbd-b905648593f8.png'>  
+*Left: GitHub Light • Right: Dracula Dark (auto-switches with OS theme)*
+
+## ✨ Features
+- 🎨 **5 gorgeous themes**: GitHub (default), Dracula, Catppuccin, Solarized, Atom
+- 🌓 **Automatic dark mode** (respects OS preference)
+- 💡 **Syntax highlighting** with copy buttons on code blocks
+- 📱 **Fully responsive** design (mobile/desktop)
+- 🔒 **No network required after first load** (CDN assets cached by browser)
+- 🚀 **Blazing fast** - pure Python, no heavy dependencies
+- 🌐 **Works everywhere**: Windows, macOS, Linux
+
+
+> what if you have some more features to add?
+
+
+### Tables rendering
+
+#### 🌓 Recommended highlight.js Themes (via `--style` flag):
+| Style Arg | Theme | Vibe |
+|-----------|-------|------|
+| `github` (default) | `github.min.css` | Familiar, professional |
+| `dracula` | `dracula.min.css` | Dark, vibrant, developer favorite |
+| `catppuccin` | `catppuccin-macchiato.min.css` | Modern pastel dark theme |
+| `solarized` | `solarized-dark.min.css` | Classic low-contrast |
+| `atom` | `atom-one-dark.min.css` | Smooth dark UI |
+
+> 💡 **Pro Insight**: `github-markdown-css` **already includes dark mode** via system preference detection. Pair with a dark `highlight.js` theme (e.g., `dracula`) for full dark-mode harmony.
+
+## 📦 Installation
+
+### Option 1: Install as package (recommended)
+```bash
+pip install .
+```
+
+### Example of rendered Python code
+
+```python
+#!/usr/bin/env python3
+"""
+md-preview: Render Markdown files with beautiful themes in your browser
+"""
+import argparse
+import html
+import pathlib
+import sys
+import tempfile
+import webbrowser
+
+try:
+    import markdown
+except ImportError:
+    print("❌ 'markdown' library not found. Install with: pip install markdown", file=sys.stderr)
+    sys.exit(1)
+
+# CORRECTED THEME MAPPINGS (verified CDN paths)
+THEME_MAP = {
+    "github": "github.min",
+    "dracula": "dracula.min",
+    "catppuccin": "catppuccin.min",  # FIXED: was catppuccin-macchiato (invalid CDN path)
+    "solarized": "solarized-dark.min",
+    "atom": "atom-one-dark.min",
+}
+DEFAULT_THEME = "github"
+HIGHLIGHT_VERSION = "11.9.0"  # For cache-busting
+```

md_preview-1.0.0/md_preview/__main__.py

@@ -0,0 +1,302 @@
+#!/usr/bin/env python3
+"""
+md-preview: Render Markdown with TRUE Bootstrap styling (all elements)
+"""
+import argparse
+import html
+import pathlib
+import sys
+import tempfile
+import webbrowser
+from string import Template  # CRITICAL: Avoids all brace conflicts
+
+try:
+    import markdown
+except ImportError:
+    print("❌ 'markdown' library not found. Install with: pip install markdown", file=sys.stderr)
+    sys.exit(1)
+
+# BOOTSTRAP THEMES (Bootswatch) + MATCHING SYNTAX HIGHLIGHTING
+BOOTSTRAP_THEMES = {
+    "default": {  # Cosmo: Friendly blue
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/cosmo/bootstrap.min.css",
+        "hljs": "github"
+    },
+    "darkly": {  # Dark theme with vibrant accents
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/darkly/bootstrap.min.css",
+        "hljs": "github-dark"
+    },
+    "flatly": {  # Clean flat design (popular)
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/flatly/bootstrap.min.css",
+        "hljs": "github"
+    },
+    "cyborg": {  # Futuristic dark
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/cyborg/bootstrap.min.css",
+        "hljs": "dracula"
+    },
+    "superhero": {  # Bold dark theme
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/superhero/bootstrap.min.css",
+        "hljs": "github-dark"
+    },
+    "litera": {  # Clean light theme
+        "css": "https://cdn.jsdelivr.net/npm/bootswatch@5.3.2/dist/litera/bootstrap.min.css",
+        "hljs": "github"
+    }
+}
+DEFAULT_THEME = "default"
+HLJS_VERSION = "11.9.0"
+
+# ✅ SAFE TEMPLATE: Uses $placeholders (no brace conflicts!)
+#    CSS/JS can use normal {} braces freely
+HTML_TEMPLATE = Template("""<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>$safe_title • Bootstrap Markdown Preview</title>
+  <link rel="stylesheet" href="$bootstrap_css">
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/$hljs_version/styles/$hljs_theme.min.css">
+  <style>
+    body {
+      padding-top: 2rem;
+      padding-bottom: 2rem;
+      background-color: var(--bs-body-bg);
+      color: var(--bs-body-color);
+    }
+    .preview-card {
+      border-radius: 0.6rem;
+      box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15);
+      transition: transform 0.3s;
+    }
+    .preview-card:hover {
+      transform: translateY(-2px);
+    }
+    /* RESPONSIVE IMAGES - FIXED OVERFLOW */
+    .card-body img {
+      max-width: 100%;
+      height: auto;
+      border-radius: 0.25rem;
+      box-shadow: 0 0.125rem 0.25rem rgba(0,0,0,0.075);
+    }
+    /* Preserve inline flow for small/icons */
+    .card-body p img {
+      display: inline;
+      margin: 0;
+      box-shadow: none;
+      border-radius: 0;
+    }
+    /* Code blocks */
+    pre {
+      border-radius: 0.4rem !important;
+      padding: 1.25rem !important;
+      background-color: var(--bs-tertiary-bg) !important;
+      border: 1px solid var(--bs-border-color) !important;
+      position: relative;
+    }
+    code {
+      background-color: var(--bs-tertiary-bg);
+      border-radius: 0.25rem;
+      padding: 0.15em 0.3em;
+    }
+    .table th {
+      font-weight: 600;
+    }
+    /* Copy button */
+    .copy-btn {
+      position: absolute;
+      top: 0.5rem;
+      right: 0.5rem;
+      padding: 0.25rem 0.5rem;
+      font-size: 0.85rem;
+      background: var(--bs-secondary-bg);
+      border: 1px solid var(--bs-border-color);
+      border-radius: 0.3rem;
+      opacity: 0.8;
+      transition: all 0.2s;
+      z-index: 10;
+    }
+    .copy-btn:hover {
+      opacity: 1;
+      background: var(--bs-tertiary-bg);
+    }
+    .copy-btn:active {
+      transform: scale(0.95);
+    }
+    /* Blockquote styling */
+    blockquote {
+      border-left: 3px solid var(--bs-primary);
+      padding-left: 1rem;
+      margin-left: 0;
+      font-style: italic;
+      color: var(--bs-secondary-color);
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="row justify-content-center">
+      <div class="col-lg-10 col-xl-9">
+        <div class="card preview-card border-0">
+          <div class="card-body p-4 p-md-5">
+            $html_content
+          </div>
+        </div>
+        <div class="text-center text-muted mt-3">
+          <small>Rendered with Bootstrap • Theme: <strong>$theme_name</strong></small>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    document.addEventListener('DOMContentLoaded', () => {
+      // Style tables
+      document.querySelectorAll('table').forEach(table => {
+        table.classList.add('table', 'table-striped', 'table-hover', 'align-middle');
+        table.querySelectorAll('thead tr').forEach(tr => {
+          tr.classList.add('table-dark');
+        });
+      });
+      
+      // Style blockquotes with Unicode quote
+      document.querySelectorAll('blockquote').forEach(blockquote => {
+        blockquote.classList.add('alert', 'alert-primary', 'mb-4', 'p-3');
+        blockquote.innerHTML = '❝ ' + blockquote.innerHTML;
+      });
+      
+      // Copy buttons
+      document.querySelectorAll('pre code').forEach((block) => {
+        const btn = document.createElement('button');
+        btn.innerHTML = '📋 Copy';
+        btn.className = 'copy-btn btn btn-sm';
+        btn.onclick = (e) => {
+          e.stopPropagation();
+          navigator.clipboard.writeText(block.textContent).then(() => {
+            const original = btn.innerHTML;
+            btn.innerHTML = '✅ Copied!';
+            setTimeout(() => { btn.innerHTML = original; }, 1500);
+          });
+        };
+        block.parentNode.appendChild(btn);
+      });
+      
+      if (typeof hljs !== 'undefined') {
+        hljs.highlightAll();
+      }
+    });
+  </script>
+  
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/$hljs_version/highlight.min.js"></script>
+</body>
+</html>""")
+
+
+def render_markdown(md_text: str) -> str:
+    """Convert Markdown to HTML with Bootstrap-friendly extensions"""
+    return markdown.markdown(
+        md_text,
+        extensions=[
+            "extra",      # Tables, fenced code, etc.
+            "nl2br",      # Line breaks
+            "sane_lists", # Better list handling
+            "toc"         # Optional: adds #anchors for headings
+        ],
+        output_format="html5"
+    )
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="✨ Render Markdown with TRUE Bootstrap styling (headers, tables, lists, code, images)",
+        epilog="Examples:\n"
+               "  md-preview report.md\n"
+               "  md-preview notes.md --style darkly\n"
+               "  md-preview docs.md --style flatly\n\n"
+               "Themes affect ENTIRE PAGE (not just code):\n"
+               "  default, flatly, litera → Light themes\n"
+               "  darkly, cyborg, superhero → Dark themes",
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    parser.add_argument("file", help="Path to Markdown file (.md)")
+    parser.add_argument(
+        "--style",
+        choices=list(BOOTSTRAP_THEMES.keys()),
+        default=DEFAULT_THEME,
+        metavar="THEME",
+        help=f"Bootstrap theme for ENTIRE PAGE (default: {DEFAULT_THEME}). "
+             f"Options: {', '.join(BOOTSTRAP_THEMES.keys())}"
+    )
+    parser.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="Generate HTML but skip opening browser"
+    )
+    
+    args = parser.parse_args()
+    
+    # Validate file
+    md_path = pathlib.Path(args.file).resolve()
+    if not md_path.exists():
+        print(f"❌ Error: File not found: {md_path}", file=sys.stderr)
+        sys.exit(1)
+    
+    # Read content
+    try:
+        md_content = md_path.read_text(encoding="utf-8")
+    except Exception as e:
+        print(f"❌ Error reading file: {e}", file=sys.stderr)
+        sys.exit(1)
+    
+    # Convert Markdown
+    try:
+        html_body = render_markdown(md_content)
+    except Exception as e:
+        print(f"❌ Conversion failed: {e}", file=sys.stderr)
+        sys.exit(1)
+    
+    # Get theme config
+    theme_config = BOOTSTRAP_THEMES.get(args.style, BOOTSTRAP_THEMES[DEFAULT_THEME])
+    title = md_path.stem.replace("_", " ").replace("-", " ").title()
+    
+    # ✅ SAFE SUBSTITUTION: No brace conflicts possible
+    full_html = HTML_TEMPLATE.substitute(
+        safe_title=html.escape(title),
+        bootstrap_css=theme_config["css"],
+        hljs_theme=theme_config["hljs"],
+        hljs_version=HLJS_VERSION,
+        html_content=html_body,
+        theme_name=args.style.capitalize()
+    )
+    
+    # Save to temp file
+    try:
+        with tempfile.NamedTemporaryFile(
+            mode="w",
+            suffix=".html",
+            delete=False,
+            encoding="utf-8",
+            prefix=f"md_preview_{md_path.stem}_"
+        ) as tmp:
+            tmp.write(full_html)
+            tmp_path = pathlib.Path(tmp.name)
+    except Exception as e:
+        print(f"❌ File write failed: {e}", file=sys.stderr)
+        sys.exit(1)
+    
+    # Open browser
+    if not args.no_browser:
+        try:
+            webbrowser.open(tmp_path.as_uri())
+            theme_type = "🌙 Dark" if args.style in ["darkly", "cyborg", "superhero"] else "☀️ Light"
+            print(f"✅ Previewing '{md_path.name}' with {theme_type} Bootstrap theme: '{args.style}'")
+            print(f"🖼️  Images now scale responsively within content area!")
+        except Exception as e:
+            print(f"⚠️ Browser failed (file saved): {e}", file=sys.stderr)
+            print(f"📁 Open manually: {tmp_path}")
+    else:
+        print(f"✅ HTML saved: {tmp_path}")
+        print(f"🌐 Open: file://{tmp_path}")
+
+
+if __name__ == "__main__":
+    main()

md_preview-1.0.0/md_preview.egg-info/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: md-preview
+Version: 1.0.0
+Summary: Render Markdown files with beautiful Bootstrap styling in your browser
+Author-email: Your Name <your.email@example.com>
+Maintainer-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/fabiomatricardi/markdown-preview-pypi-package
+Project-URL: Documentation, https://github.com/fabiomatricardi/markdown-preview-pypi-package#readme
+Project-URL: Repository, https://github.com/fabiomatricardi/markdown-preview-pypi-package
+Project-URL: Changelog, https://github.com/fabiomatricardi/markdown-preview-pypi-package/releases
+Keywords: markdown,preview,bootstrap,cli,documentation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown>=3.4
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# 🌟 md-preview v2.0
+
+**TRUE BOOTSTRAP RENDERING** - Headers, tables, lists, blockquotes, and code blocks all styled with authentic Bootstrap aesthetics. No more "GitHub CSS + random code theme" mismatch!
+
+![Bootstrap Preview](https://blog.ronin.cloud/content/images/size/w2000/2022/02/markdown.png)  
+*Left: Flatly theme • Right: Darkly theme (full UI consistency)*
+
+## ✨ What Changed in v2.0?
+| Feature | v1.x | v2.0 |
+|---------|------|------|
+| **Headers** | GitHub style | ✅ Bootstrap typography |
+| **Tables** | Basic borders | ✅ `.table-striped` + hover effects |
+| **Blockquotes** | Plain italics | ✅ Bootstrap alerts with icons |
+| **Lists** | Default bullets | ✅ Bootstrap spacing & semantics |
+| **Code Blocks** | Only syntax colored | ✅ Full Bootstrap card styling + copy buttons |
+| **Theme Scope** | Code blocks only | ✅ **ENTIRE PAGE** (true UI kit) |
+| **Responsiveness** | Limited | ✅ Mobile-first Bootstrap grid |
+
+## 🎨 Available Bootstrap Themes
+| Theme | CLI Flag | Type | Best For |
+|-------|----------|------|----------|
+| **Cosmo** | `default` | Light | Friendly documentation |
+| **Flatly** | `flatly` | Light | Modern clean interfaces |
+| **Litera** | `litera` | Light | Readable long-form content |
+| **Darkly** | `darkly` | Dark | Dark mode lovers (vibrant) |
+| **Cyborg** | `cyborg` | Dark | Futuristic/terminal aesthetic |
+| **Superhero** | `superhero` | Dark | Bold presentations |
+
+> 💡 **All themes include**:  
+> - Responsive tables with hover effects  
+> - Blockquotes styled as Bootstrap alerts  
+> - Consistent spacing & typography  
+> - Mobile-optimized layout  
+> - Syntax highlighting that matches theme mode
+
+## 🚀 Usage
+```bash
+# Install updated package
+pip install --upgrade .
+
+# Preview with default Bootstrap theme (Cosmo)
+md-preview README.md
+
+# Use popular Flatly theme (clean light design)
+md-preview report.md --style flatly
+
+# Dark mode workflow
+md-preview notes.md --style darkly
+
+# See ALL elements styled consistently:
+echo '# Header\n\n- List item\n\n| Table | Header |\n|-------|--------|\n| Cell  | Data   |\n\n> Blockquote\n\n```python\nprint("Code")\n```' > test.md
+md-preview test.md --style cyborg
+```
+
+---
+
+# 🌟 md-preview
+
+Render Markdown files with beautiful, modern themes directly in your browser. Zero configuration, instant preview.
+
+<img src='https://user-images.githubusercontent.com/11283502/116907735-a58d7280-ac4a-11eb-8dbd-b905648593f8.png'>  
+*Left: GitHub Light • Right: Dracula Dark (auto-switches with OS theme)*
+
+## ✨ Features
+- 🎨 **5 gorgeous themes**: GitHub (default), Dracula, Catppuccin, Solarized, Atom
+- 🌓 **Automatic dark mode** (respects OS preference)
+- 💡 **Syntax highlighting** with copy buttons on code blocks
+- 📱 **Fully responsive** design (mobile/desktop)
+- 🔒 **No network required after first load** (CDN assets cached by browser)
+- 🚀 **Blazing fast** - pure Python, no heavy dependencies
+- 🌐 **Works everywhere**: Windows, macOS, Linux
+
+
+> what if you have some more features to add?
+
+
+### Tables rendering
+
+#### 🌓 Recommended highlight.js Themes (via `--style` flag):
+| Style Arg | Theme | Vibe |
+|-----------|-------|------|
+| `github` (default) | `github.min.css` | Familiar, professional |
+| `dracula` | `dracula.min.css` | Dark, vibrant, developer favorite |
+| `catppuccin` | `catppuccin-macchiato.min.css` | Modern pastel dark theme |
+| `solarized` | `solarized-dark.min.css` | Classic low-contrast |
+| `atom` | `atom-one-dark.min.css` | Smooth dark UI |
+
+> 💡 **Pro Insight**: `github-markdown-css` **already includes dark mode** via system preference detection. Pair with a dark `highlight.js` theme (e.g., `dracula`) for full dark-mode harmony.
+
+## 📦 Installation
+
+### Option 1: Install as package (recommended)
+```bash
+pip install .
+```
+
+### Example of rendered Python code
+
+```python
+#!/usr/bin/env python3
+"""
+md-preview: Render Markdown files with beautiful themes in your browser
+"""
+import argparse
+import html
+import pathlib
+import sys
+import tempfile
+import webbrowser
+
+try:
+    import markdown
+except ImportError:
+    print("❌ 'markdown' library not found. Install with: pip install markdown", file=sys.stderr)
+    sys.exit(1)
+
+# CORRECTED THEME MAPPINGS (verified CDN paths)
+THEME_MAP = {
+    "github": "github.min",
+    "dracula": "dracula.min",
+    "catppuccin": "catppuccin.min",  # FIXED: was catppuccin-macchiato (invalid CDN path)
+    "solarized": "solarized-dark.min",
+    "atom": "atom-one-dark.min",
+}
+DEFAULT_THEME = "github"
+HIGHLIGHT_VERSION = "11.9.0"  # For cache-busting
+```

md_preview-1.0.0/md_preview.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+md_preview/__main__.py
+md_preview.egg-info/PKG-INFO
+md_preview.egg-info/SOURCES.txt
+md_preview.egg-info/dependency_links.txt
+md_preview.egg-info/entry_points.txt
+md_preview.egg-info/requires.txt
+md_preview.egg-info/top_level.txt

md_preview-1.0.0/md_preview.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

md_preview-1.0.0/md_preview.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+md-preview = md_preview.__main__:main

md_preview-1.0.0/md_preview.egg-info/requires.txt

@@ -0,0 +1,6 @@
+markdown>=3.4
+
+[dev]
+build
+twine
+pytest

md_preview-1.0.0/md_preview.egg-info/top_level.txt

@@ -0,0 +1 @@
+md_preview

md_preview-1.0.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "md-preview"
+version = "1.0.0"  # 🔑 SEMVER: MAJOR.MINOR.PATCH
+description = "Render Markdown files with beautiful Bootstrap styling in your browser"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+maintainers = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+keywords = ["markdown", "preview", "bootstrap", "cli", "documentation"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Text Processing :: Markup",
+    "Topic :: Utilities",
+    "Typing :: Typed"
+]
+dependencies = [
+    "markdown>=3.4",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "twine",
+    "pytest",
+]
+
+[project.urls]
+Homepage = "https://github.com/fabiomatricardi/markdown-preview-pypi-package"
+Documentation = "https://github.com/fabiomatricardi/markdown-preview-pypi-package#readme"
+Repository = "https://github.com/fabiomatricardi/markdown-preview-pypi-package"
+Changelog = "https://github.com/fabiomatricardi/markdown-preview-pypi-package/releases"
+
+[project.scripts]
+md-preview = "md_preview.__main__:main"
+
+[tool.setuptools]
+packages = ["md_preview"]
+
+[tool.setuptools.package-data]
+md_preview = ["py.typed"]  # For type checkers (optional)

md_preview-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+