Try workaround for github/markup#295

README.rst

@@ -5,9 +5,7 @@ zpy
 Manage Python Environments in Zsh, with uv or pip-tools
 -------------------------------------------------------
 
-.. image:: https://github.com/AndydeCleyre/zpy/blob/assets/zpy-logo.png?raw=true
-   :alt: zpy logo
-   :width: 10%
+|logo|
 
 |ghpages| |reqs-ci| |container-ci|
 
@@ -35,9 +33,7 @@ They can generally replace pipenv, poetry, pipx, pipsi, virtualenvwrapper, etc.
 
 .. contents::
 
-.. image:: https://user-images.githubusercontent.com/1787385/172661113-7a2c6670-e716-491e-8db4-c005fef8455b.png
-   :alt: zpy supercommand completions
-   :width: 100%
+|zpy-completions|
 
 Getting It
 ----------
@@ -105,15 +101,11 @@ They are also available as subcommands to the "supercommand" ``zpy``;
 
 Basic usage of ``envin`` and ``pipacs``:
 
-.. image:: https://github.com/AndydeCleyre/zpy/blob/assets/envin_pipacs.gif?raw=true
-   :alt: Animated envin and pipacs demo
-   :width: 100%
+|envin-pipacs-gif|
 
 Basic usage of ``pipz``:
 
-.. image:: https://github.com/AndydeCleyre/zpy/blob/assets/pipz.gif?raw=true
-   :alt: Animated pipz demo
-   :width: 100%
+|pipz-gif|
 
 Try it in a Container
 ---------------------
@@ -197,3 +189,19 @@ __ https://github.com/AndydeCleyre/zpy/issues
 .. |ghpages| image:: https://github.com/AndydeCleyre/zpy/actions/workflows/gh-pages.yml/badge.svg?branch=master
    :alt: Build GitHub Pages
    :target: https://andydecleyre.github.io/zpy/
+
+.. |logo| image:: https://github.com/AndydeCleyre/zpy/blob/assets/zpy-logo.png?raw=true
+   :alt: zpy logo
+   :width: 160px
+
+.. |zpy-completions| image:: https://user-images.githubusercontent.com/1787385/172661113-7a2c6670-e716-491e-8db4-c005fef8455b.png
+   :alt: zpy supercommand completions
+   :width: 800px
+
+.. |envin-pipacs-gif| image:: https://github.com/AndydeCleyre/zpy/blob/assets/envin_pipacs.gif?raw=true
+   :alt: Animated envin and pipacs demo
+   :width: 800px
+
+.. |pipz-gif| image:: https://github.com/AndydeCleyre/zpy/blob/assets/pipz.gif?raw=true
+   :alt: Animated pipz demo
+   :width: 800px