medium-writer-mcp 0.2.1__tar.gz

medium_writer_mcp-0.2.1/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+.env
+dist/
+.pytest_cache/
+*.medium.html
+posts/

medium_writer_mcp-0.2.1/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.2.1 (2026-11-11)
+
+First version on PyPI (the 0.2.0 release job never ran).
+
+- Subtitle is pasted as a small heading, so Medium styles it as the subtitle
+  instead of a section heading.
+- Apostrophes outside code are curled (’) before pasting, so a paragraph no
+  longer mixes ' and ’.
+- The "Medium doesn't highlight code" warning is gone (Medium highlights code
+  blocks itself). The formatter now only flags code blocks over 30 lines.
+
+## 0.2.0 (2026-11-11)
+
+Tagged but not published.
+
+- `open_in_medium` (macOS): copies the prepared article to the clipboard as rich
+  text and opens a new Medium story in your browser. No login, no automation.
+- `export_article`: writes a paste-ready HTML page, for any OS.
+- `prepare_article`: checks and rewrites Markdown for what Medium supports.
+- `get_user_stories`, `get_publication_stories`, `get_tag_stories`: read Medium's
+  public RSS feeds.
+- `draft_from_code` prompt: drafts an article from code in your project.
+- HTTPS uses the OS trust store (`truststore`), so it works with python.org
+  Python on macOS.
+- Legacy publishing tools when a pre-2025 `MEDIUM_INTEGRATION_TOKEN` is set.

medium_writer_mcp-0.2.1/LICENSE

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

medium_writer_mcp-0.2.1/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.5
+Name: medium-writer-mcp
+Version: 0.2.1
+Summary: MCP server for reading Medium and getting your articles Medium-ready, no API token needed
+Project-URL: Homepage, https://github.com/MuhammadAsher/medium-mcp
+Project-URL: Issues, https://github.com/MuhammadAsher/medium-mcp/issues
+Project-URL: Changelog, https://github.com/MuhammadAsher/medium-mcp/blob/main/CHANGELOG.md
+Author: Muhammad Asher
+License-Expression: MIT
+License-File: LICENSE
+Keywords: blogging,claude,mcp,medium,model-context-protocol,writing
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.10
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: truststore>=0.9
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# medium-writer-mcp
+
+[![CI](https://github.com/MuhammadAsher/medium-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/MuhammadAsher/medium-mcp/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/medium-writer-mcp)](https://pypi.org/project/medium-writer-mcp/)
+
+An MCP server that lets Claude read Medium and get your articles Medium-ready.
+Works in Claude Code (terminal or the VS Code extension), the Claude desktop app,
+and any other MCP client.
+
+## How it works (no token needed)
+
+1. **Research**: ask Claude what's being written under a tag or by an author.
+2. **Draft**: `/mcp__medium__draft_from_code <topic>` writes an article from code in your project.
+3. **Prepare**: `prepare_article` fixes what Medium can't display (tables, deep headings, checklists)
+   and warns about the rest.
+4. **Open in Medium** (macOS): `open_in_medium` copies the article to your clipboard as
+   formatted text and opens [medium.com/new-story](https://medium.com/new-story) in Safari,
+   where you're already signed in. Click the title line, press Cmd+V, review, and publish.
+   Medium keeps headings, bold, links, lists, quotes, images and code blocks.
+   Add tags and subtitle in Medium's publish dialog.
+
+   Not on macOS? `export_article` writes `<post>.medium.html` instead: open it,
+   click in the article, Cmd+A, Cmd+C, and paste into Medium.
+
+There's no Medium login in this server, on purpose. Medium no longer gives new apps
+API access, and its site blocks automated browsers, so the server hands the article
+to your normal browser and you do the final paste.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `get_user_stories` | Latest stories by an author, with full text (public RSS) |
+| `get_publication_stories` | Latest stories in a publication |
+| `get_tag_stories` | Latest stories under a tag (Medium only includes an excerpt here) |
+| `prepare_article` | Checks Markdown against what Medium supports, fixes what it can, returns warnings, word count and reading time |
+| `export_article` | Runs `prepare_article`, then writes a paste-ready HTML page |
+| `open_in_medium` | macOS: runs `prepare_article`, copies the result as rich text, opens a new Medium story. Replaces your clipboard |
+
+Plus one prompt, `draft_from_code`, which shows up as a slash command in Claude Code.
+
+**Limits to know**
+- RSS feeds only return the ~10 newest stories. There's no full archive or stats.
+- Medium has no public way to post without an API token, and stopped issuing
+  tokens in January 2025, hence the copy-paste step.
+
+## Install
+
+Add it to Claude Code for all your projects (needs [uv](https://docs.astral.sh/uv/)):
+
+```bash
+claude mcp add --scope user medium -- uvx medium-writer-mcp
+```
+
+Start a new Claude Code session and type `/mcp` to confirm `medium` is connected.
+It works the same in the VS Code extension and the terminal.
+
+For the Claude desktop app or another MCP client, add this to its config:
+
+```json
+{
+  "mcpServers": {
+    "medium": { "command": "uvx", "args": ["medium-writer-mcp"] }
+  }
+}
+```
+
+Without uv: `pip install medium-writer-mcp` and use `medium-writer-mcp` as the command.
+
+### Choosing the browser
+
+`open_in_medium` uses Safari unless told otherwise. Pass `browser` per call, or set
+a default with an environment variable (any app name from /Applications, or `default`
+for your system browser):
+
+```bash
+claude mcp add --scope user medium -e MEDIUM_BROWSER="Google Chrome" -- uvx medium-writer-mcp
+```
+
+## Try it
+
+- "What has @username published on Medium lately?"
+- "What's being written under the fastapi tag this week? Summarize the angles."
+- "/mcp__medium__draft_from_code the caching layer in src/cache"
+- "Run prepare_article on docs/post.md and fix the warnings."
+- "Open docs/post.md in Medium."
+
+## Development
+
+```bash
+git clone https://github.com/MuhammadAsher/medium-mcp.git
+cd medium-mcp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest            # 43 tests, all offline
+```
+
+To run your local copy in Claude Code, point the command at `.venv/bin/medium-mcp`.
+
+Releasing: bump `__version__` in `src/medium_mcp/__init__.py`, add a CHANGELOG entry,
+then push a matching tag (`git tag v0.2.1 && git push --tags`). GitHub Actions tests,
+builds and publishes to PyPI.
+
+## Project layout
+
+```
+src/medium_mcp/
+  server.py      MCP tools, prompt, entry point
+  feeds.py       RSS fetch/parse, HTML -> Markdown (stdlib only)
+  formatter.py   Medium compatibility checks and rewrites
+  export.py      Markdown -> paste-ready HTML
+  handoff.py     macOS clipboard + open browser (osascript, open)
+  _http.py       HTTPS using the OS trust store
+  medium_api.py  Legacy REST client (token only)
+tests/           Offline tests with a fixture feed
+```
+
+Dependencies: the `mcp` SDK (v2) and `truststore` (so HTTPS works with python.org
+builds on macOS). HTTP, XML and Markdown use the standard library.
+
+## Legacy: direct publishing with an old token
+
+Only if you have an integration token created before January 2025. Setting one adds
+`get_medium_profile`, `list_my_publications`, `upload_image` and `create_post`
+(defaults to draft; Medium's API can't edit or delete posts afterwards).
+
+```json
+"medium": {
+  "command": "uvx",
+  "args": ["medium-writer-mcp"],
+  "env": { "MEDIUM_INTEGRATION_TOKEN": "your-token" }
+}
+```
+
+Don't commit a `.mcp.json` that contains your token. Put it in
+`~/.claude.json` via `claude mcp add --scope user ... -e MEDIUM_INTEGRATION_TOKEN=...`
+instead.

medium_writer_mcp-0.2.1/README.md

@@ -0,0 +1,137 @@
+# medium-writer-mcp
+
+[![CI](https://github.com/MuhammadAsher/medium-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/MuhammadAsher/medium-mcp/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/medium-writer-mcp)](https://pypi.org/project/medium-writer-mcp/)
+
+An MCP server that lets Claude read Medium and get your articles Medium-ready.
+Works in Claude Code (terminal or the VS Code extension), the Claude desktop app,
+and any other MCP client.
+
+## How it works (no token needed)
+
+1. **Research**: ask Claude what's being written under a tag or by an author.
+2. **Draft**: `/mcp__medium__draft_from_code <topic>` writes an article from code in your project.
+3. **Prepare**: `prepare_article` fixes what Medium can't display (tables, deep headings, checklists)
+   and warns about the rest.
+4. **Open in Medium** (macOS): `open_in_medium` copies the article to your clipboard as
+   formatted text and opens [medium.com/new-story](https://medium.com/new-story) in Safari,
+   where you're already signed in. Click the title line, press Cmd+V, review, and publish.
+   Medium keeps headings, bold, links, lists, quotes, images and code blocks.
+   Add tags and subtitle in Medium's publish dialog.
+
+   Not on macOS? `export_article` writes `<post>.medium.html` instead: open it,
+   click in the article, Cmd+A, Cmd+C, and paste into Medium.
+
+There's no Medium login in this server, on purpose. Medium no longer gives new apps
+API access, and its site blocks automated browsers, so the server hands the article
+to your normal browser and you do the final paste.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `get_user_stories` | Latest stories by an author, with full text (public RSS) |
+| `get_publication_stories` | Latest stories in a publication |
+| `get_tag_stories` | Latest stories under a tag (Medium only includes an excerpt here) |
+| `prepare_article` | Checks Markdown against what Medium supports, fixes what it can, returns warnings, word count and reading time |
+| `export_article` | Runs `prepare_article`, then writes a paste-ready HTML page |
+| `open_in_medium` | macOS: runs `prepare_article`, copies the result as rich text, opens a new Medium story. Replaces your clipboard |
+
+Plus one prompt, `draft_from_code`, which shows up as a slash command in Claude Code.
+
+**Limits to know**
+- RSS feeds only return the ~10 newest stories. There's no full archive or stats.
+- Medium has no public way to post without an API token, and stopped issuing
+  tokens in January 2025, hence the copy-paste step.
+
+## Install
+
+Add it to Claude Code for all your projects (needs [uv](https://docs.astral.sh/uv/)):
+
+```bash
+claude mcp add --scope user medium -- uvx medium-writer-mcp
+```
+
+Start a new Claude Code session and type `/mcp` to confirm `medium` is connected.
+It works the same in the VS Code extension and the terminal.
+
+For the Claude desktop app or another MCP client, add this to its config:
+
+```json
+{
+  "mcpServers": {
+    "medium": { "command": "uvx", "args": ["medium-writer-mcp"] }
+  }
+}
+```
+
+Without uv: `pip install medium-writer-mcp` and use `medium-writer-mcp` as the command.
+
+### Choosing the browser
+
+`open_in_medium` uses Safari unless told otherwise. Pass `browser` per call, or set
+a default with an environment variable (any app name from /Applications, or `default`
+for your system browser):
+
+```bash
+claude mcp add --scope user medium -e MEDIUM_BROWSER="Google Chrome" -- uvx medium-writer-mcp
+```
+
+## Try it
+
+- "What has @username published on Medium lately?"
+- "What's being written under the fastapi tag this week? Summarize the angles."
+- "/mcp__medium__draft_from_code the caching layer in src/cache"
+- "Run prepare_article on docs/post.md and fix the warnings."
+- "Open docs/post.md in Medium."
+
+## Development
+
+```bash
+git clone https://github.com/MuhammadAsher/medium-mcp.git
+cd medium-mcp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest            # 43 tests, all offline
+```
+
+To run your local copy in Claude Code, point the command at `.venv/bin/medium-mcp`.
+
+Releasing: bump `__version__` in `src/medium_mcp/__init__.py`, add a CHANGELOG entry,
+then push a matching tag (`git tag v0.2.1 && git push --tags`). GitHub Actions tests,
+builds and publishes to PyPI.
+
+## Project layout
+
+```
+src/medium_mcp/
+  server.py      MCP tools, prompt, entry point
+  feeds.py       RSS fetch/parse, HTML -> Markdown (stdlib only)
+  formatter.py   Medium compatibility checks and rewrites
+  export.py      Markdown -> paste-ready HTML
+  handoff.py     macOS clipboard + open browser (osascript, open)
+  _http.py       HTTPS using the OS trust store
+  medium_api.py  Legacy REST client (token only)
+tests/           Offline tests with a fixture feed
+```
+
+Dependencies: the `mcp` SDK (v2) and `truststore` (so HTTPS works with python.org
+builds on macOS). HTTP, XML and Markdown use the standard library.
+
+## Legacy: direct publishing with an old token
+
+Only if you have an integration token created before January 2025. Setting one adds
+`get_medium_profile`, `list_my_publications`, `upload_image` and `create_post`
+(defaults to draft; Medium's API can't edit or delete posts afterwards).
+
+```json
+"medium": {
+  "command": "uvx",
+  "args": ["medium-writer-mcp"],
+  "env": { "MEDIUM_INTEGRATION_TOKEN": "your-token" }
+}
+```
+
+Don't commit a `.mcp.json` that contains your token. Put it in
+`~/.claude.json` via `claude mcp add --scope user ... -e MEDIUM_INTEGRATION_TOKEN=...`
+instead.

medium_writer_mcp-0.2.1/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "medium-writer-mcp"
+dynamic = ["version"]
+description = "MCP server for reading Medium and getting your articles Medium-ready, no API token needed"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Muhammad Asher" }]
+keywords = ["mcp", "medium", "claude", "model-context-protocol", "writing", "blogging"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Text Processing :: Markup :: Markdown",
+]
+dependencies = ["mcp>=2.3,<3", "truststore>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/MuhammadAsher/medium-mcp"
+Issues = "https://github.com/MuhammadAsher/medium-mcp/issues"
+Changelog = "https://github.com/MuhammadAsher/medium-mcp/blob/main/CHANGELOG.md"
+
+[project.scripts]
+medium-writer-mcp = "medium_mcp.server:main"
+medium-mcp = "medium_mcp.server:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+path = "src/medium_mcp/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/medium_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

medium_writer_mcp-0.2.1/src/medium_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""medium-writer-mcp: an MCP server for reading Medium and getting articles Medium-ready."""
+
+__version__ = "0.2.1"

medium_writer_mcp-0.2.1/src/medium_mcp/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()

medium_writer_mcp-0.2.1/src/medium_mcp/_http.py

@@ -0,0 +1,23 @@
+"""Shared HTTPS context.
+
+Python from python.org on macOS ships without a CA bundle, so plain urllib fails
+with CERTIFICATE_VERIFY_FAILED until "Install Certificates.command" is run.
+truststore verifies against the operating system's trust store instead, which
+works out of the box on macOS, Windows and Linux.
+"""
+
+from __future__ import annotations
+
+import ssl
+import urllib.request
+
+try:
+    import truststore
+
+    SSL_CONTEXT: ssl.SSLContext = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
+except ImportError:  # pragma: no cover - truststore is a declared dependency
+    SSL_CONTEXT = ssl.create_default_context()
+
+
+def urlopen(req: urllib.request.Request, timeout: float):
+    return urllib.request.urlopen(req, timeout=timeout, context=SSL_CONTEXT)

medium_writer_mcp-0.2.1/src/medium_mcp/export.py

@@ -0,0 +1,218 @@
+"""Turn Medium-ready Markdown into an HTML page you can copy-paste into Medium.
+
+Medium's editor keeps formatting when you paste rich text from a browser, but
+not when you paste raw Markdown. So the no-token workflow is:
+
+    prepare_article -> export_article -> open the .html -> Cmd+A, Cmd+C -> paste into Medium
+
+This is a deliberately small Markdown converter covering exactly what Medium
+supports: two heading sizes, paragraphs, bold/italic/inline code, links,
+images, bulleted and numbered lists, block quotes, code blocks and dividers.
+Standard library only.
+"""
+
+from __future__ import annotations
+
+import html
+import re
+
+_FENCE_RE = re.compile(r"^\s*(```|~~~)")
+_HEADING_RE = re.compile(r"^(#{1,6})\s+(.*?)\s*#*\s*$")
+_UL_RE = re.compile(r"^\s*[-*+]\s+(.*)$")
+_OL_RE = re.compile(r"^\s*\d+[.)]\s+(.*)$")
+_HR_RE = re.compile(r"^\s*([-*_])(\s*\1){2,}\s*$")
+_QUOTE_RE = re.compile(r"^\s*>\s?(.*)$")
+_IMAGE_LINE_RE = re.compile(r'^\s*!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)\s*$')
+
+_PAGE = """<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{title}</title>
+<style>
+  body {{ max-width: 680px; margin: 2rem auto; padding: 0 16px; font: 20px/1.6 Georgia, serif; color: #242424; background: #fff; }}
+  .howto {{ font: 14px/1.5 -apple-system, system-ui, sans-serif; background: #f2f7f2; border: 1px solid #cfe3cf;
+            border-radius: 6px; padding: 10px 14px; margin-bottom: 2rem; }}
+  h1, h2, h3 {{ font-family: -apple-system, system-ui, sans-serif; line-height: 1.25; }}
+  pre {{ background: #f2f2f2; padding: 14px; overflow-x: auto; font-size: 15px; }}
+  code {{ background: #f2f2f2; padding: 1px 4px; font-size: 0.85em; }}
+  pre code {{ background: none; padding: 0; }}
+  blockquote {{ border-left: 3px solid #242424; margin-left: 0; padding-left: 20px; font-style: italic; }}
+  img {{ max-width: 100%; }}
+  figcaption {{ text-align: center; font-size: 15px; color: #6b6b6b; }}
+</style>
+</head>
+<body>
+<div class="howto" contenteditable="false">
+  <strong>To paste into Medium:</strong> click inside the article below, press Cmd+A then Cmd+C,
+  open <a href="https://medium.com/new-story">medium.com/new-story</a> and press Cmd+V.
+  Tags, subtitle and canonical URL go in Medium's publish dialog.
+</div>
+<article contenteditable="true">
+{body}
+</article>
+</body>
+</html>
+"""
+
+
+def markdown_to_html(markdown: str) -> str:
+    """Convert Medium-flavoured Markdown to an HTML fragment."""
+    lines = markdown.replace("\r\n", "\n").split("\n")
+    out: list[str] = []
+    para: list[str] = []
+    list_kind: str | None = None  # "ul" | "ol"
+    quote: list[str] = []
+    i = 0
+
+    def flush_para() -> None:
+        if para:
+            out.append(f"<p>{inline(' '.join(s.strip() for s in para))}</p>")
+            para.clear()
+
+    def close_list() -> None:
+        nonlocal list_kind
+        if list_kind:
+            out.append(f"</{list_kind}>")
+            list_kind = None
+
+    def flush_quote() -> None:
+        if quote:
+            out.append(f"<blockquote><p>{inline(' '.join(s.strip() for s in quote))}</p></blockquote>")
+            quote.clear()
+
+    def flush_all() -> None:
+        flush_para()
+        close_list()
+        flush_quote()
+
+    while i < len(lines):
+        line = lines[i]
+
+        fence = _FENCE_RE.match(line)
+        if fence:
+            flush_all()
+            marker = fence.group(1)
+            code: list[str] = []
+            i += 1
+            while i < len(lines) and not lines[i].strip().startswith(marker):
+                code.append(lines[i])
+                i += 1
+            out.append(f"<pre><code>{html.escape(chr(10).join(code))}</code></pre>")
+            i += 1  # skip closing fence (or run off the end if unclosed)
+            continue
+
+        if not line.strip():
+            flush_all()
+            i += 1
+            continue
+
+        m = _HEADING_RE.match(line)
+        if m:
+            flush_all()
+            level = min(len(m.group(1)), 3)
+            out.append(f"<h{level}>{inline(m.group(2))}</h{level}>")
+            i += 1
+            continue
+
+        if _HR_RE.match(line):
+            flush_all()
+            out.append("<hr>")
+            i += 1
+            continue
+
+        m = _IMAGE_LINE_RE.match(line)
+        if m:
+            flush_all()
+            alt, src, caption = m.group(1), m.group(2), m.group(3)
+            fig = f'<figure><img src="{html.escape(src, quote=True)}" alt="{html.escape(alt, quote=True)}">'
+            if caption:
+                fig += f"<figcaption>{inline(caption)}</figcaption>"
+            out.append(fig + "</figure>")
+            i += 1
+            continue
+
+        m = _QUOTE_RE.match(line)
+        if m:
+            flush_para()
+            close_list()
+            quote.append(m.group(1))
+            i += 1
+            continue
+        flush_quote()
+
+        ul, ol = _UL_RE.match(line), _OL_RE.match(line)
+        if ul or ol:
+            flush_para()
+            kind = "ul" if ul else "ol"
+            if list_kind != kind:
+                close_list()
+                out.append(f"<{kind}>")
+                list_kind = kind
+            out.append(f"<li>{inline((ul or ol).group(1))}</li>")
+            i += 1
+            continue
+
+        if list_kind and line.startswith((" ", "\t")):
+            # Continuation of the previous list item: append to it.
+            out[-1] = out[-1][: -len("</li>")] + " " + inline(line.strip()) + "</li>"
+            i += 1
+            continue
+
+        close_list()
+        para.append(line)
+        i += 1
+
+    flush_all()
+    return "\n".join(out)
+
+
+def inline(text: str) -> str:
+    """Inline Markdown -> HTML. Code spans are protected from other rules."""
+    spans: list[str] = []
+
+    def stash_code(m: re.Match) -> str:
+        spans.append(f"<code>{html.escape(m.group(1))}</code>")
+        return f"\x00{len(spans) - 1}\x00"
+
+    text = re.sub(r"`([^`]+)`", stash_code, text)
+    text = html.escape(text, quote=False)
+    text = re.sub(
+        r"!\[([^\]]*)\]\(([^)\s]+)[^)]*\)",
+        lambda m: f'<img src="{_attr(m.group(2))}" alt="{_attr(m.group(1))}">',
+        text,
+    )
+    text = re.sub(
+        r"\[([^\]]+)\]\(([^)\s]+)[^)]*\)",
+        lambda m: f'<a href="{_attr(m.group(2))}">{m.group(1)}</a>',
+        text,
+    )
+    text = re.sub(r"(\*\*|__)(?=\S)(.+?)(?<=\S)\1", r"<strong>\2</strong>", text)
+    text = re.sub(r"(?<![\w*])\*(?=\S)(.+?)(?<=\S)\*(?![\w*])", r"<em>\1</em>", text)
+    text = re.sub(r"(?<![\w_])_(?=\S)(.+?)(?<=\S)_(?![\w_])", r"<em>\1</em>", text)
+    text = re.sub(r"~~(?=\S)(.+?)(?<=\S)~~", r"<s>\1</s>", text)
+    text = _curl_apostrophes(text)
+    return re.sub(r"\x00(\d+)\x00", lambda m: spans[int(m.group(1))], text)
+
+
+def _curl_apostrophes(text: str) -> str:
+    """Turn word-internal ' into ’ outside tags (code spans are already stashed).
+
+    Medium curls apostrophes on paste, but not reliably after an inline code
+    span, which leaves a mix of ' and ’ in one paragraph. Doing it here keeps
+    them consistent.
+    """
+    parts = re.split(r"(<[^>]*>)", text)
+    return "".join(
+        p if p.startswith("<") else re.sub(r"(?<=\w)'(?=\w)", "\u2019", p) for p in parts
+    )
+
+
+def _attr(value: str) -> str:
+    # Input is already HTML-escaped (minus quotes); only quotes need escaping here.
+    return value.replace('"', "&quot;")
+
+
+def render_page(title: str, body_html: str) -> str:
+    return _PAGE.format(title=html.escape(title or "Medium draft"), body=body_html)