md2html-tailwind4 1.0.0__tar.gz

md2html_tailwind4-1.0.0/.github/workflows/python-publish.yml

@@ -0,0 +1,67 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build release distributions
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      url: https://pypi.org/p/md2html-tailwind4
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

md2html_tailwind4-1.0.0/.gitignore

@@ -0,0 +1,208 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+markdown2html_tailwind.py

md2html_tailwind4-1.0.0/.python-version

@@ -0,0 +1 @@
+3.11

md2html_tailwind4-1.0.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-04-15
+
+### Added
+
+- Initial release of `md2html-tailwind4`
+- `Converter` class with `convert_md_to_html()` method
+- Tailwind CSS 4 class annotations for all standard HTML elements (h1–h6, p, ul, ol, li, blockquote, img, pre, code, strong, em, a, hr)
+- Responsive table styling with overflow scrolling
+- Audio table support: 3-column tables with media URLs are converted to interactive audio player widgets
+- Django template delimiter escaping (`{{ }}`, `{% %}`, `{# #}`) inside code blocks
+- External links automatically get `target="_blank"` and `rel="noopener noreferrer"`
+- Dark mode support via Tailwind `dark:` variants
+- CLI entry point: `md2html input.md output.html`
+- `src/` layout for clean PyPI packaging with `hatchling` build backend

md2html_tailwind4-1.0.0/LICENSE

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

md2html_tailwind4-1.0.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: md2html-tailwind4
+Version: 1.0.0
+Summary: A Python package that converts Markdown to HTML using Tailwind CSS 4 for styling.
+Author-email: "White Neuron Co., Ltd." <contact@whiteneuron.com>
+License: MIT License
+        
+        Copyright (c) 2026 White Neuron
+        
+        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.
+License-File: LICENSE
+Keywords: converter,html,markdown,tailwind,tailwindcss
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.14.3
+Requires-Dist: markdown>=3.10.2
+Description-Content-Type: text/markdown
+
+# md2html-tailwind4
+
+A Python package that converts Markdown to clean, styled HTML using **Tailwind CSS 4** classes.
+
+Designed for projects that render HTML inside a Tailwind-powered frontend (Django, FastAPI, static sites, etc.). No build step required — just pass in Markdown, get back ready-to-render HTML.
+
+## Features
+
+- Converts Markdown to HTML with full Tailwind CSS 4 class annotations
+- Responsive tables with overflow scrolling
+- Audio table support (3-column tables with media URLs become interactive audio players)
+- Automatically escapes Django template delimiters (`{{ }}`, `{% %}`) inside code blocks
+- External links get `target="_blank"` and `rel="noopener noreferrer"` automatically
+- Dark mode support via Tailwind's `dark:` variants
+- CLI tool included
+
+## Installation
+
+```bash
+pip install md2html-tailwind4
+```
+
+## Usage
+
+### Python API
+
+```python
+from md2html_tailwind4 import Converter
+
+converter = Converter()
+html = converter.convert_md_to_html("# Hello\n\nThis is **Markdown**.")
+print(html)
+```
+
+### Command Line
+
+```bash
+md2html input.md output.html
+```
+
+## Requirements
+
+- Python >= 3.11
+
+## License
+
+MIT — White Neuron Co., Ltd.

md2html_tailwind4-1.0.0/README.md

@@ -0,0 +1,47 @@
+# md2html-tailwind4
+
+A Python package that converts Markdown to clean, styled HTML using **Tailwind CSS 4** classes.
+
+Designed for projects that render HTML inside a Tailwind-powered frontend (Django, FastAPI, static sites, etc.). No build step required — just pass in Markdown, get back ready-to-render HTML.
+
+## Features
+
+- Converts Markdown to HTML with full Tailwind CSS 4 class annotations
+- Responsive tables with overflow scrolling
+- Audio table support (3-column tables with media URLs become interactive audio players)
+- Automatically escapes Django template delimiters (`{{ }}`, `{% %}`) inside code blocks
+- External links get `target="_blank"` and `rel="noopener noreferrer"` automatically
+- Dark mode support via Tailwind's `dark:` variants
+- CLI tool included
+
+## Installation
+
+```bash
+pip install md2html-tailwind4
+```
+
+## Usage
+
+### Python API
+
+```python
+from md2html_tailwind4 import Converter
+
+converter = Converter()
+html = converter.convert_md_to_html("# Hello\n\nThis is **Markdown**.")
+print(html)
+```
+
+### Command Line
+
+```bash
+md2html input.md output.html
+```
+
+## Requirements
+
+- Python >= 3.11
+
+## License
+
+MIT — White Neuron Co., Ltd.

md2html_tailwind4-1.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "md2html-tailwind4"
+version = "1.0.0"
+description = "A Python package that converts Markdown to HTML using Tailwind CSS 4 for styling."
+authors = [
+    { name = "White Neuron Co., Ltd.", email = "contact@whiteneuron.com" },
+]
+license = { file = "LICENSE" }
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["markdown", "html", "tailwind", "tailwindcss", "converter"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Text Processing :: Markup :: HTML",
+    "Topic :: Text Processing :: Markup :: Markdown",
+]
+dependencies = [
+    "beautifulsoup4>=4.14.3",
+    "markdown>=3.10.2",
+]
+
+[project.scripts]
+md2html = "md2html_tailwind4.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/md2html_tailwind4"]

md2html_tailwind4-1.0.0/src/md2html_tailwind4/__init__.py

@@ -0,0 +1,3 @@
+from .converter import Converter
+
+__all__ = ["Converter"]

md2html_tailwind4-1.0.0/src/md2html_tailwind4/cli.py

@@ -0,0 +1,26 @@
+import argparse
+
+from .converter import Converter
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog='md2html',
+        description='Convert Markdown to HTML with Tailwind CSS 4 classes.',
+    )
+    parser.add_argument('input', help='Path to the input Markdown file')
+    parser.add_argument('output', help='Path to the output HTML file')
+    args = parser.parse_args()
+
+    with open(args.input, 'r', encoding='utf-8') as f:
+        markdown_content = f.read()
+
+    converter = Converter()
+    html_content = converter.convert_md_to_html(markdown_content)
+
+    with open(args.output, 'w', encoding='utf-8') as f:
+        f.write(html_content)
+
+
+if __name__ == '__main__':
+    main()

md2html_tailwind4-1.0.0/src/md2html_tailwind4/converter.py

@@ -0,0 +1,208 @@
+import markdown
+import re
+from bs4 import BeautifulSoup
+
+
+class Converter:
+    def __init__(self):
+        pass
+
+    def convert_md_to_html(self, markdown_content):
+        # Convert Markdown to HTML with richer extensions for broader content support.
+        html_content = markdown.markdown(
+            markdown_content,
+            extensions=['tables', 'attr_list', 'fenced_code', 'sane_lists', 'nl2br'],
+        )
+
+        # Parse the HTML content and convert tables to custom divs
+        soup = BeautifulSoup(html_content, 'html.parser')
+
+        # Add Tailwind classes to various elements
+        self.add_tailwind_classes(soup)
+
+        # Convert tables to custom divs
+        self.convert_tables(soup)
+
+        # Escape Django template delimiters in code examples so they render literally.
+        self.escape_django_template_syntax_in_code_blocks(soup)
+
+        # Create the full HTML content with JavaScript for play/pause toggle
+        full_html_content = self.create_full_html(soup)
+
+        return full_html_content
+
+    def add_tailwind_classes(self, soup):
+        for h1 in soup.find_all('h1'):
+            h1['class'] = 'text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight mb-4 sm:mb-5 text-neutral-900 dark:text-neutral-100'
+
+        for h2 in soup.find_all('h2'):
+            h2['class'] = 'text-xl sm:text-2xl lg:text-3xl font-bold tracking-tight mt-8 mb-3 text-neutral-900 dark:text-neutral-100'
+
+        for h3 in soup.find_all('h3'):
+            h3['class'] = 'text-lg sm:text-xl lg:text-2xl font-semibold mt-6 mb-3 text-neutral-900 dark:text-neutral-100'
+
+        for h4 in soup.find_all('h4'):
+            h4['class'] = 'text-base sm:text-lg font-semibold mt-5 mb-2 text-neutral-800 dark:text-neutral-200'
+
+        for h5 in soup.find_all('h5'):
+            h5['class'] = 'text-base font-semibold mt-4 mb-2 text-neutral-800 dark:text-neutral-200'
+
+        for h6 in soup.find_all('h6'):
+            h6['class'] = 'text-sm font-semibold uppercase tracking-wide mt-4 mb-2 text-neutral-700 dark:text-neutral-300'
+
+        for p in soup.find_all('p'):
+            p['class'] = 'mb-4 text-base leading-7 text-pretty text-justify text-neutral-800 dark:text-neutral-200'
+
+        for ul in soup.find_all('ul'):
+            ul['class'] = 'list-disc list-outside pl-6 mb-4 space-y-1 text-base leading-7 text-justify text-neutral-800 dark:text-neutral-200'
+
+        for ol in soup.find_all('ol'):
+            ol['class'] = 'list-decimal list-outside pl-6 mb-4 space-y-1 text-base leading-7 text-justify text-neutral-800 dark:text-neutral-200'
+
+        for li in soup.find_all('li'):
+            li['class'] = 'leading-7'
+
+        for blockquote in soup.find_all('blockquote'):
+            blockquote['class'] = 'mb-5 p-4 sm:p-5 rounded-r-xl border-l-4 bg-neutral-100 text-neutral-700 border-neutral-400 italic text-base leading-7 quote dark:bg-neutral-900/60 dark:text-neutral-300 dark:border-neutral-600'
+
+        for img in soup.find_all('img'):
+            img['class'] = 'mx-auto my-5 w-full max-w-4xl h-auto rounded-xl border border-neutral-200 shadow-sm dark:border-neutral-700 dark:shadow-neutral-950/30'
+
+        for pre in soup.find_all('pre'):
+            pre['class'] = 'my-5 overflow-x-auto rounded-xl border border-neutral-200 bg-neutral-950 p-4 text-sm leading-6 text-neutral-100 dark:border-neutral-700 dark:bg-neutral-950 dark:text-neutral-100'
+
+        for code in soup.find_all('code'):
+            if code.parent and code.parent.name == 'pre':
+                code['class'] = 'bg-transparent p-0 text-inherit font-mono'
+            else:
+                code['class'] = 'px-1.5 py-0.5 rounded-md bg-neutral-100 text-[0.9em] font-mono text-neutral-900 dark:bg-neutral-800 dark:text-neutral-100'
+
+        for strong in soup.find_all('strong'):
+            strong['class'] = 'font-semibold text-neutral-900 dark:text-neutral-100'
+
+        for em in soup.find_all('em'):
+            em['class'] = 'italic text-neutral-700 dark:text-neutral-300'
+
+        for a in soup.find_all('a'):
+            a['class'] = 'text-sky-700 underline decoration-sky-300 underline-offset-2 hover:text-sky-900 transition-colors dark:text-sky-300 dark:decoration-sky-600 dark:hover:text-sky-200'
+            if a.get('href', '').startswith(('http://', 'https://')):
+                a['target'] = '_blank'
+                a['rel'] = 'noopener noreferrer'
+
+        for hr in soup.find_all('hr'):
+            hr['class'] = 'my-8 border-neutral-300 dark:border-neutral-700'
+
+    def convert_tables(self, soup):
+        for table in soup.find_all('table'):
+            rows = table.find_all('tr')
+            if len(rows) == 0:
+                continue
+
+            # Check if the first row is a header
+            first_row_cells = rows[0].find_all(['th', 'td'])
+            has_headers = len(first_row_cells) == 3 and all(th.name == 'th' for th in first_row_cells)
+
+            # Only convert dedicated audio tables; keep all other tables semantic/responsive.
+            if not has_headers or not self._is_audio_table(rows):
+                self._style_as_responsive_table(soup, table)
+                continue
+
+            start_index = 1 if has_headers else 0
+            divs = []
+
+            for row in rows[start_index:]:
+                cells = row.find_all(['td', 'th'])
+                if len(cells) >= 2:  # Ensure there are at least two cells per row
+                    div = soup.new_tag('div', **{'class': 'my-3 rounded-xl border border-neutral-200 bg-white p-3 sm:p-4 shadow-sm flex flex-col sm:flex-row sm:items-center sm:justify-center gap-2 sm:gap-3 dark:border-neutral-700 dark:bg-neutral-900 dark:shadow-neutral-950/30'})
+                    span1 = soup.new_tag('span', **{'class': 'font-semibold rounded-lg bg-neutral-800 px-3 py-2 text-white text-sm sm:text-base dark:bg-neutral-700'})
+                    span1.string = cells[0].get_text()
+                    span2 = soup.new_tag('span', **{'class': 'font-semibold rounded-lg bg-neutral-700 px-3 py-2 text-white text-sm sm:text-base break-words dark:bg-neutral-600'})
+                    span2_content = cells[1].get_text()
+                    span2.append(soup.new_string(span2_content))
+                    if len(cells) == 3 and cells[2].get_text().strip():
+                        audio_button = soup.new_tag('button', **{'class': 'audio-button ml-2', 'data-state': 'play'})
+                        audio_button.string = '▶️'
+                        audio_url = cells[2].get_text().strip()
+                        audio_id = span2_content.lower().replace(' ', '_').replace('[', '').replace(']', '')
+                        audio = soup.new_tag('audio', **{'src': audio_url, 'class': 'hidden', 'controls': ''})
+                        audio_button['onclick'] = f"togglePlayPause('{audio_id}', this);"
+                        audio['id'] = audio_id
+                        span2.append(audio_button)
+                        span2.append(audio)
+                    div.append(span1)
+                    div.append(span2)
+                    divs.append(div)
+            if divs:
+                table.replace_with(*divs)
+            else:
+                table.decompose()
+
+    @staticmethod
+    def _is_audio_table(rows):
+        # Audio-table mode is only valid when the 3rd column consistently contains media URLs.
+        media_suffixes = ('.mp3', '.wav', '.ogg', '.m4a', '.aac', '.webm')
+        data_rows = rows[1:] if len(rows) > 1 else []
+        if not data_rows:
+            return False
+
+        third_values = []
+        for row in data_rows:
+            cells = row.find_all(['td', 'th'])
+            if len(cells) < 3:
+                return False
+            third_values.append(cells[2].get_text().strip().lower())
+
+        if not all(third_values):
+            return False
+
+        return all(value.startswith(('http://', 'https://', '/')) or value.endswith(media_suffixes) for value in third_values)
+
+    def _style_as_responsive_table(self, soup, table):
+        table['class'] = 'min-w-full border-collapse text-sm sm:text-base'
+        table['style'] = 'color: var(--color-base-content); border-color: var(--color-base-300);'
+
+        thead = table.find('thead')
+        if thead:
+            thead['class'] = ''
+            thead['style'] = 'background-color: var(--color-base-300); color: var(--color-base-content);'
+        for th in table.find_all('th'):
+            th['class'] = 'border px-3 py-2 text-left font-semibold whitespace-nowrap'
+            th['style'] = 'border-color: var(--color-base-300); color: var(--color-base-content);'
+
+        for td in table.find_all('td'):
+            td['class'] = 'border px-3 py-2 align-top'
+            td['style'] = 'border-color: var(--color-base-300); color: var(--color-base-content);'
+
+        wrapper = soup.new_tag(
+            'div',
+            **{
+                'class': 'my-5 overflow-x-auto rounded-xl border shadow-sm',
+                'style': 'border-color: var(--color-base-300); background-color: var(--color-base-100); color: var(--color-base-content);',
+            },
+        )
+        table.wrap(wrapper)
+
+    def create_full_html(self, soup):
+        return str(soup)
+
+    def escape_django_template_syntax_in_code_blocks(self, soup):
+        for tag in soup.find_all(['code', 'pre']):
+            # Keep code samples readable while preventing Django template parsing.
+            if tag.string is not None:
+                tag.string.replace_with(self._escape_django_delimiters(str(tag.string)))
+                continue
+
+            for text_node in tag.find_all(string=True):
+                text_node.replace_with(self._escape_django_delimiters(str(text_node)))
+
+    @staticmethod
+    def _escape_django_delimiters(text):
+        token_map = {
+            '{{': '{% templatetag openvariable %}',
+            '}}': '{% templatetag closevariable %}',
+            '{%': '{% templatetag openblock %}',
+            '%}': '{% templatetag closeblock %}',
+            '{#': '{% templatetag opencomment %}',
+            '#}': '{% templatetag closecomment %}',
+        }
+        return re.sub(r'\{\{|\}\}|\{%|%\}|\{#|#\}', lambda m: token_map[m.group(0)], text)

md2html_tailwind4-1.0.0/uv.lock

@@ -0,0 +1,57 @@
+version = 1
+requires-python = ">=3.11"
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.14.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "soupsieve" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721 },
+]
+
+[[package]]
+name = "markdown"
+version = "3.10.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2b/f4/69fa6ed85ae003c2378ffa8f6d2e3234662abd02c10d216c0ba96081a238/markdown-3.10.2.tar.gz", hash = "sha256:994d51325d25ad8aa7ce4ebaec003febcce822c3f8c911e3b17c52f7f589f950", size = 368805 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/1f/77fa3081e4f66ca3576c896ae5d31c3002ac6607f9747d2e3aa49227e464/markdown-3.10.2-py3-none-any.whl", hash = "sha256:e91464b71ae3ee7afd3017d9f358ef0baf158fd9a298db92f1d4761133824c36", size = 108180 },
+]
+
+[[package]]
+name = "md2html-tailwind4"
+version = "0.1.0"
+source = { virtual = "." }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "markdown" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "beautifulsoup4", specifier = ">=4.14.3" },
+    { name = "markdown", specifier = ">=3.10.2" },
+]
+
+[[package]]
+name = "soupsieve"
+version = "2.8.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7b/ae/2d9c981590ed9999a0d91755b47fc74f74de286b0f5cee14c9269041e6c4/soupsieve-2.8.3.tar.gz", hash = "sha256:3267f1eeea4251fb42728b6dfb746edc9acaffc4a45b27e19450b676586e8349", size = 118627 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl", hash = "sha256:ed64f2ba4eebeab06cc4962affce381647455978ffc1e36bb79a545b91f45a95", size = 37016 },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614 },
+]