word2html 0.3.0__tar.gz → 0.5.0__tar.gz

word2html-0.5.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly

word2html-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,116 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  UV_VERSION: "0.13.7"
+  PANDOC_VERSION: "3.13"
+  # Keep in sync with MIN_PANDOC_VERSION in word2html/pandoc.py.
+  PANDOC_MINIMUM: "3.6"
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+      - run: uv lock --check
+      - run: uv run --locked ruff check
+      - run: uv run --locked ruff format --check
+      - run: uv run --locked mypy
+
+  test:
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.12", "3.13", "3.14", "3.15"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: ${{ env.UV_VERSION }}
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+      - uses: pandoc/actions/setup@86321b6dd4675f5014c611e05088e10d4939e09e # v1.1.1
+        if: runner.os == 'Linux'
+        with:
+          version: ${{ env.PANDOC_VERSION }}
+      # The setup action installs an x86_64 build on macOS, but macos-latest is arm64.
+      - name: Install native pandoc on macOS
+        if: runner.os == 'macOS'
+        shell: bash
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release download "$PANDOC_VERSION" --repo jgm/pandoc \
+            --pattern '*-arm64-macOS.zip' --dir "$RUNNER_TEMP/pandoc"
+          unzip -q "$RUNNER_TEMP"/pandoc/*.zip -d "$RUNNER_TEMP/pandoc"
+          dirname "$(find "$RUNNER_TEMP/pandoc" -type f -name pandoc | head -n 1)" >> "$GITHUB_PATH"
+      - run: pandoc --version
+      - run: uv run --locked pytest --cov
+
+  pandoc-minimum:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: ${{ env.UV_VERSION }}
+          python-version: "3.12"
+          enable-cache: true
+      - uses: pandoc/actions/setup@86321b6dd4675f5014c611e05088e10d4939e09e # v1.1.1
+        with:
+          version: ${{ env.PANDOC_MINIMUM }}
+      - run: pandoc --version
+      - run: uv run --locked pytest
+
+  package:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+      - uses: pandoc/actions/setup@86321b6dd4675f5014c611e05088e10d4939e09e # v1.1.1
+        with:
+          version: ${{ env.PANDOC_VERSION }}
+      - run: uv build
+      - name: Install the wheel into a clean environment and convert a document
+        shell: bash
+        run: |
+          uv venv "$RUNNER_TEMP/clean"
+          uv pip install --python "$RUNNER_TEMP/clean/bin/python" dist/*.whl
+          cd "$RUNNER_TEMP"
+          "$RUNNER_TEMP/clean/bin/word2html" --version
+          printf '# Hello\n\nCaf\xc3\xa9\n' | pandoc --from=markdown --to=docx --output=sample.docx
+          "$RUNNER_TEMP/clean/bin/word2html" --strict sample.docx
+          grep -q 'Café' sample.html

word2html-0.5.0/.gitignore

@@ -0,0 +1,33 @@
+# Virtual environments
+env/
+.venv/
+venv/
+
+# Python artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store
+Thumbs.db

{word2html-0.3.0 → word2html-0.5.0}/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2017, Brad Montgomery <brad@bradmontgomery.net>
+Copyright (c) 2025-2026, Brad Montgomery <brad@bradmontgomery.net>
 
 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

word2html-0.5.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.5
+Name: word2html
+Version: 0.5.0
+Summary: Convert a Word (docx) document to HTML, safely, using pandoc.
+Project-URL: Homepage, https://github.com/bradmontgomery/word2html
+Author-email: Brad Montgomery <brad@bradmontgomery.net>
+License-Expression: MIT
+License-File: LICENSE.txt
+Keywords: docx,html,pandoc,word
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# 🌟 Convert a Word Doc to html
+
+[![CI](https://github.com/bradmontgomery/word2html/actions/workflows/ci.yml/badge.svg)](https://github.com/bradmontgomery/word2html/actions/workflows/ci.yml)
+
+`word2html` turns a `.docx` file into a single, self-contained HTML5 file. It uses
+[pandoc](https://pandoc.org/) for the conversion, and adds checks for malformed
+documents, unsafe links, and hidden text.
+
+## 📋 Requirements
+
+- **pandoc 3.6 or newer.** This is a separate program: `uvx` and `pip` do **not** install it.
+- Python 3.12 or newer.
+
+Install pandoc with one of these:
+
+| Platform | Command |
+|---|---|
+| macOS | `brew install pandoc` |
+| Debian / Ubuntu | `sudo apt install pandoc` |
+| Windows | `winget install JohnMacFarlane.Pandoc` |
+| Anything else | See the [pandoc installation guide](https://pandoc.org/installing.html) |
+
+Then check the version, because Linux distribution packages can be older than word2html needs:
+
+    pandoc --version
+
+For example, `apt` doesn't install a new enough pandoc on Debian 12 or 13, or on Ubuntu 24.04.
+If yours is too old, use an installer from the
+[pandoc releases page](https://github.com/jgm/pandoc/releases). word2html is tested on Linux and
+macOS on Python 3.12 to 3.15; Windows is not tested.
+
+## 🚀 Quick Start with uvx
+
+The easiest way to run word2html without installing it is using `uvx`:
+
+    uvx word2html /path/to/MyGloriousDoc.docx
+
+This will give you a new file, `/path/to/MyGloriousDoc.html`.
+
+## 💾 Installation
+
+To install with uv:
+
+    uv tool install word2html
+
+Or with pip:
+
+    pip install word2html
+
+Then run:
+
+    word2html /path/to/MyGloriousDoc.docx
+
+## 🛠️ Usage
+
+    word2html [-h] [--version] [--strict] [--timeout SECONDS]
+              [--max-memory SIZE] [--max-file-size SIZE] path
+
+| Option | Default | What it does |
+|---|---|---|
+| `--strict` | off | Refuse documents with unsafe links or hidden text instead of warning |
+| `--timeout SECONDS` | `120` | Stop pandoc after this long |
+| `--max-memory SIZE` | `2G` | Memory limit for pandoc, such as `512M` |
+| `--max-file-size SIZE` | `200M` | Largest input file to accept |
+| `--version` | | Show the version |
+
+The output is written next to the input, with the same name and an `.html` extension. **An
+existing file with that name is replaced.** The replacement is atomic: if conversion fails or is
+refused, an existing file is left untouched. If the output path is a symlink, the symlink itself
+is replaced and its target isn't changed.
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Converted. Any warnings were printed to stderr |
+| `1` | Invalid input, a limit was exceeded, or pandoc or the output write failed |
+| `2` | Bad command line |
+| `3` | Refused for safety. Nothing was written |
+
+## 🔒 Security
+
+Word documents can contain things you don't want to publish. Here's what word2html does about
+them:
+
+| Found in the document | Default | With `--strict` |
+|---|---|---|
+| Unsafe links | Warn on stderr, convert | Refuse (exit 3) |
+| Hidden text | Warn on stderr, convert | Refuse (exit 3) |
+| Active content | Refuse (exit 3) | Refuse (exit 3) |
+
+> ⚠️ **By default, flagged links and hidden text are still in the HTML.** The warning is the only
+> protection. Use `--strict` in scripts and automation, where nobody may read stderr.
+
+**Unsafe links** are any link or source URL that doesn't use `http`, `https`, `mailto`, `tel`, or
+`ftp`, and isn't a relative path or `#fragment`. That covers `javascript:`, `data:`, and `file:`
+links, including disguised forms such as `JaVaScRiPt:` or `java<tab>script:`. A warning looks like:
+
+    word2html: warning: unsafe link: javascript:alert(1)
+
+**Hidden text** is text formatted as hidden in Word, whether directly or through a style. pandoc
+publishes it as ordinary visible text. The warning says how much was found and where, but never
+repeats the text, so it can't leak into logs:
+
+    word2html: warning: 1 run(s) of text hidden in Word will be visible in the HTML (word/document.xml)
+
+To remove it, open the document in Word and use **File › Info › Check for Issues › Inspect
+Document**, or show hidden text and delete it.
+
+**Active content** is anything that could run without being clicked, such as an "image" that is
+really an HTML or JavaScript file. Word documents don't normally contain it, so it is always
+refused. Embedded images (including SVG, which can't run scripts inside `<img>`), PDFs, video and
+audio are fine.
+
+### Converting documents you don't trust
+
+word2html's checks are not a complete HTML sanitizer. If you publish HTML made from documents you
+don't trust, use `--strict` and also run the result through an HTML sanitizer, as
+[pandoc's security notes](https://pandoc.org/MANUAL.html#a-note-on-security) recommend.
+
+## 🛡️ Malformed documents and limits
+
+Every document is checked before pandoc sees it. These are rejected with a clear error (exit 1):
+
+- Files that aren't really `.docx`, including empty, truncated, and non-zip files
+- Password-protected and legacy `.doc` files
+- Archives with encrypted members, duplicate members, or unsafe paths such as `../evil`
+- Missing required parts, or XML that isn't well-formed
+- XML with a `DOCTYPE`, which blocks external-entity and "billion laughs" attacks
+
+These limits stop small files from running away with your machine's memory or time:
+
+| Limit | Value | Change with |
+|---|---|---|
+| Input file size | 200 MiB | `--max-file-size` |
+| pandoc memory | 2 GiB | `--max-memory` |
+| pandoc run time | 120 seconds | `--timeout` |
+| Total uncompressed size | 1 GiB | Fixed |
+| Size of one XML part | 64 MiB | Fixed |
+| Files in the archive | 10,000 | Fixed |
+| XML nesting depth | 256 levels | Fixed |
+
+The memory limit is a cap, not a target: a small hostile file can still use up to the limit before
+it's stopped, so lower `--max-memory` if you convert untrusted documents on a shared machine.
+
+A very long document can also reach it legitimately, because embedding images makes pandoc use
+about 200 MB of memory per MB of document XML. With the default limit, that's about 10 MB of XML
+in a document with images, or the full 64 MiB without them. Large images themselves cost little.
+If you hit the limit, the error tells you, and `--max-memory 8G` (for example) allows more.
+
+## 📝 Known behaviour
+
+- **Tracked changes:** insertions are published as if accepted, while deletions are dropped.
+- **Comments and document properties** (such as author) are not published.
+- **Linked images**, meaning images stored outside the document, are dropped with a warning. They
+  are never fetched or read from disk. Images whose file is missing from the document also warn.
+- **File size:** images are embedded in the HTML, so output can be larger than the `.docx`, and
+  documents with images need more memory to convert.
+- **Styling:** output uses pandoc's default CSS.
+
+## ⬆️ Upgrading from 0.4
+
+- pypandoc, pytidylib, and libtidy are no longer used, and there are no Python dependencies. You
+  now need only pandoc 3.6 or newer.
+- Output is now HTML5 with a declared charset and pandoc's default CSS, rather than tidied HTML 4.
+  Highlights and footnote sections survive, and images are embedded rather than broken.
+- Exit code `3` is new, and warnings on stderr have a new format.
+- For Python callers, `convert_to_html()` now returns a `ConversionResult` and no longer prints.
+  Warnings are in `result.warnings`. Its options are `strict=` and `limits=`, and errors derive
+  from `WordToHtmlError`. `FileNotFoundError` is unchanged, and invalid files still raise a
+  `ValueError` subclass.
+
+## 🧪 Development
+
+You'll need [uv](https://docs.astral.sh/uv/) and pandoc. The tests fail rather than skip if pandoc
+isn't installed.
+
+    uv sync                     # install dependencies
+    uv run pytest --cov         # run tests with coverage
+    uv run ruff check           # lint
+    uv run ruff format --check  # check formatting
+    uv run mypy                 # check types
+    uv build                    # build the package
+
+Every pull request runs all of these on GitHub Actions, across Linux and macOS, every supported
+Python version, and the oldest supported pandoc.
+
+## 📝 Note on Licenses
+
+This code is MIT-licensed. It runs [pandoc](https://pandoc.org/), a separate program released under
+the GPL, which you install yourself. word2html doesn't include or link to any pandoc code.
+
+## ⭐ Star History
+
+This project _really_ started out as a joke -- although this is something I've done too many times. I'm always
+amazed at how many people have starred this repo. 🤩
+
+<a href="https://www.star-history.com/#bradmontgomery/word2html&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&legend=top-left" />
+ </picture>
+</a>

word2html-0.5.0/README.md

@@ -0,0 +1,204 @@
+# 🌟 Convert a Word Doc to html
+
+[![CI](https://github.com/bradmontgomery/word2html/actions/workflows/ci.yml/badge.svg)](https://github.com/bradmontgomery/word2html/actions/workflows/ci.yml)
+
+`word2html` turns a `.docx` file into a single, self-contained HTML5 file. It uses
+[pandoc](https://pandoc.org/) for the conversion, and adds checks for malformed
+documents, unsafe links, and hidden text.
+
+## 📋 Requirements
+
+- **pandoc 3.6 or newer.** This is a separate program: `uvx` and `pip` do **not** install it.
+- Python 3.12 or newer.
+
+Install pandoc with one of these:
+
+| Platform | Command |
+|---|---|
+| macOS | `brew install pandoc` |
+| Debian / Ubuntu | `sudo apt install pandoc` |
+| Windows | `winget install JohnMacFarlane.Pandoc` |
+| Anything else | See the [pandoc installation guide](https://pandoc.org/installing.html) |
+
+Then check the version, because Linux distribution packages can be older than word2html needs:
+
+    pandoc --version
+
+For example, `apt` doesn't install a new enough pandoc on Debian 12 or 13, or on Ubuntu 24.04.
+If yours is too old, use an installer from the
+[pandoc releases page](https://github.com/jgm/pandoc/releases). word2html is tested on Linux and
+macOS on Python 3.12 to 3.15; Windows is not tested.
+
+## 🚀 Quick Start with uvx
+
+The easiest way to run word2html without installing it is using `uvx`:
+
+    uvx word2html /path/to/MyGloriousDoc.docx
+
+This will give you a new file, `/path/to/MyGloriousDoc.html`.
+
+## 💾 Installation
+
+To install with uv:
+
+    uv tool install word2html
+
+Or with pip:
+
+    pip install word2html
+
+Then run:
+
+    word2html /path/to/MyGloriousDoc.docx
+
+## 🛠️ Usage
+
+    word2html [-h] [--version] [--strict] [--timeout SECONDS]
+              [--max-memory SIZE] [--max-file-size SIZE] path
+
+| Option | Default | What it does |
+|---|---|---|
+| `--strict` | off | Refuse documents with unsafe links or hidden text instead of warning |
+| `--timeout SECONDS` | `120` | Stop pandoc after this long |
+| `--max-memory SIZE` | `2G` | Memory limit for pandoc, such as `512M` |
+| `--max-file-size SIZE` | `200M` | Largest input file to accept |
+| `--version` | | Show the version |
+
+The output is written next to the input, with the same name and an `.html` extension. **An
+existing file with that name is replaced.** The replacement is atomic: if conversion fails or is
+refused, an existing file is left untouched. If the output path is a symlink, the symlink itself
+is replaced and its target isn't changed.
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Converted. Any warnings were printed to stderr |
+| `1` | Invalid input, a limit was exceeded, or pandoc or the output write failed |
+| `2` | Bad command line |
+| `3` | Refused for safety. Nothing was written |
+
+## 🔒 Security
+
+Word documents can contain things you don't want to publish. Here's what word2html does about
+them:
+
+| Found in the document | Default | With `--strict` |
+|---|---|---|
+| Unsafe links | Warn on stderr, convert | Refuse (exit 3) |
+| Hidden text | Warn on stderr, convert | Refuse (exit 3) |
+| Active content | Refuse (exit 3) | Refuse (exit 3) |
+
+> ⚠️ **By default, flagged links and hidden text are still in the HTML.** The warning is the only
+> protection. Use `--strict` in scripts and automation, where nobody may read stderr.
+
+**Unsafe links** are any link or source URL that doesn't use `http`, `https`, `mailto`, `tel`, or
+`ftp`, and isn't a relative path or `#fragment`. That covers `javascript:`, `data:`, and `file:`
+links, including disguised forms such as `JaVaScRiPt:` or `java<tab>script:`. A warning looks like:
+
+    word2html: warning: unsafe link: javascript:alert(1)
+
+**Hidden text** is text formatted as hidden in Word, whether directly or through a style. pandoc
+publishes it as ordinary visible text. The warning says how much was found and where, but never
+repeats the text, so it can't leak into logs:
+
+    word2html: warning: 1 run(s) of text hidden in Word will be visible in the HTML (word/document.xml)
+
+To remove it, open the document in Word and use **File › Info › Check for Issues › Inspect
+Document**, or show hidden text and delete it.
+
+**Active content** is anything that could run without being clicked, such as an "image" that is
+really an HTML or JavaScript file. Word documents don't normally contain it, so it is always
+refused. Embedded images (including SVG, which can't run scripts inside `<img>`), PDFs, video and
+audio are fine.
+
+### Converting documents you don't trust
+
+word2html's checks are not a complete HTML sanitizer. If you publish HTML made from documents you
+don't trust, use `--strict` and also run the result through an HTML sanitizer, as
+[pandoc's security notes](https://pandoc.org/MANUAL.html#a-note-on-security) recommend.
+
+## 🛡️ Malformed documents and limits
+
+Every document is checked before pandoc sees it. These are rejected with a clear error (exit 1):
+
+- Files that aren't really `.docx`, including empty, truncated, and non-zip files
+- Password-protected and legacy `.doc` files
+- Archives with encrypted members, duplicate members, or unsafe paths such as `../evil`
+- Missing required parts, or XML that isn't well-formed
+- XML with a `DOCTYPE`, which blocks external-entity and "billion laughs" attacks
+
+These limits stop small files from running away with your machine's memory or time:
+
+| Limit | Value | Change with |
+|---|---|---|
+| Input file size | 200 MiB | `--max-file-size` |
+| pandoc memory | 2 GiB | `--max-memory` |
+| pandoc run time | 120 seconds | `--timeout` |
+| Total uncompressed size | 1 GiB | Fixed |
+| Size of one XML part | 64 MiB | Fixed |
+| Files in the archive | 10,000 | Fixed |
+| XML nesting depth | 256 levels | Fixed |
+
+The memory limit is a cap, not a target: a small hostile file can still use up to the limit before
+it's stopped, so lower `--max-memory` if you convert untrusted documents on a shared machine.
+
+A very long document can also reach it legitimately, because embedding images makes pandoc use
+about 200 MB of memory per MB of document XML. With the default limit, that's about 10 MB of XML
+in a document with images, or the full 64 MiB without them. Large images themselves cost little.
+If you hit the limit, the error tells you, and `--max-memory 8G` (for example) allows more.
+
+## 📝 Known behaviour
+
+- **Tracked changes:** insertions are published as if accepted, while deletions are dropped.
+- **Comments and document properties** (such as author) are not published.
+- **Linked images**, meaning images stored outside the document, are dropped with a warning. They
+  are never fetched or read from disk. Images whose file is missing from the document also warn.
+- **File size:** images are embedded in the HTML, so output can be larger than the `.docx`, and
+  documents with images need more memory to convert.
+- **Styling:** output uses pandoc's default CSS.
+
+## ⬆️ Upgrading from 0.4
+
+- pypandoc, pytidylib, and libtidy are no longer used, and there are no Python dependencies. You
+  now need only pandoc 3.6 or newer.
+- Output is now HTML5 with a declared charset and pandoc's default CSS, rather than tidied HTML 4.
+  Highlights and footnote sections survive, and images are embedded rather than broken.
+- Exit code `3` is new, and warnings on stderr have a new format.
+- For Python callers, `convert_to_html()` now returns a `ConversionResult` and no longer prints.
+  Warnings are in `result.warnings`. Its options are `strict=` and `limits=`, and errors derive
+  from `WordToHtmlError`. `FileNotFoundError` is unchanged, and invalid files still raise a
+  `ValueError` subclass.
+
+## 🧪 Development
+
+You'll need [uv](https://docs.astral.sh/uv/) and pandoc. The tests fail rather than skip if pandoc
+isn't installed.
+
+    uv sync                     # install dependencies
+    uv run pytest --cov         # run tests with coverage
+    uv run ruff check           # lint
+    uv run ruff format --check  # check formatting
+    uv run mypy                 # check types
+    uv build                    # build the package
+
+Every pull request runs all of these on GitHub Actions, across Linux and macOS, every supported
+Python version, and the oldest supported pandoc.
+
+## 📝 Note on Licenses
+
+This code is MIT-licensed. It runs [pandoc](https://pandoc.org/), a separate program released under
+the GPL, which you install yourself. word2html doesn't include or link to any pandoc code.
+
+## ⭐ Star History
+
+This project _really_ started out as a joke -- although this is something I've done too many times. I'm always
+amazed at how many people have starred this repo. 🤩
+
+<a href="https://www.star-history.com/#bradmontgomery/word2html&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=bradmontgomery/word2html&type=date&legend=top-left" />
+ </picture>
+</a>