diff --git a/stubs/commonmark/METADATA.toml b/stubs/commonmark/METADATA.toml
index aa3a1922c3a1..d5b10a699d9e 100644
--- a/stubs/commonmark/METADATA.toml
+++ b/stubs/commonmark/METADATA.toml
@@ -1,2 +1,6 @@
 version = "0.9.*"
 upstream_repository = "https://github.com/rtfd/commonmark.py"
+no_longer_updated = true
+extra_description = """\
+`commonmark` is deprecated in favor of [markdown-it-py](https://pypi.org/project/markdown-it-py/).
+See [this issue](https://github.com/readthedocs/commonmark.py/issues/308) for background and discussion."""