diff --git a/.github/workflows/build-and-deploy.yml b/.github/workflows/build-and-deploy.yml
index d74fa5f..da127bd 100644
--- a/.github/workflows/build-and-deploy.yml
+++ b/.github/workflows/build-and-deploy.yml
@@ -44,6 +44,9 @@ jobs:
     - name: Build sdist
       run: pipx run build --sdist
 
+    - name: Verify README renders on PyPI (twine check)
+      run: pipx run twine check --strict dist/*.tar.gz
+
     - name: Install sdist
       run: pip install dist/*.tar.gz
 
diff --git a/README.rst b/README.rst
index 75ae152..6a2543e 100644
--- a/README.rst
+++ b/README.rst
@@ -28,10 +28,9 @@ PyVista accessor (recommended, ``pyvista >= 0.48``)
 ===================================================
 
 Installing ``pyacvd`` registers an ``acvd`` namespace on every
-:class:`pyvista.PolyData`, so uniform remeshing slots straight into a
-PyVista pipeline. Once ``pyacvd`` is imported (or auto-discovered via
-PyVista's entry-point system) you can call ``mesh.acvd.<method>(...)``
-directly:
+``pyvista.PolyData``, so uniform remeshing slots straight into a PyVista
+pipeline. Once ``pyacvd`` is imported (or auto-discovered via PyVista's
+entry-point system) you can call ``mesh.acvd.<method>(...)`` directly:
 
 .. code:: python
 
@@ -51,8 +50,8 @@ The accessor never mutates the source mesh and always returns a fresh
    one-shot uniform remesh.
 
 -  ``mesh.acvd.clustering(weights=None, subdivide=0)`` — return a
-   configured :class:`pyacvd.Clustering` for fine-grained control
-   (plotting clusters, mixing fast/uniform clustering, etc.).
+   configured ``pyacvd.Clustering`` for fine-grained control (plotting
+   clusters, mixing fast/uniform clustering, etc.).
 
 -  ``mesh.acvd.cluster_ids(n_clusters, ...)`` — per-point cluster id
    array, useful for visualization.