diff --git a/pkgs/development/python-modules/markdown-it-py/default.nix b/pkgs/development/python-modules/markdown-it-py/default.nix
index e62866961867..4fbe2e0380ce 100644
--- a/pkgs/development/python-modules/markdown-it-py/default.nix
+++ b/pkgs/development/python-modules/markdown-it-py/default.nix
@@ -1,10 +1,11 @@
 {
   lib,
-  attrs,
   buildPythonPackage,
   commonmark,
   fetchFromGitHub,
   flit-core,
+  ipykernel,
+  jupyter-sphinx,
   linkify-it-py,
   markdown,
   mdit-py-plugins,
@@ -21,31 +22,28 @@
   stdenv,
   pytest-regressions,
   pytestCheckHook,
-  pythonOlder,
 }:
 
 buildPythonPackage rec {
   pname = "markdown-it-py";
-  version = "3.0.0";
-  format = "pyproject";
-
-  disabled = pythonOlder "3.6";
+  version = "4.0.0";
+  pyproject = true;
 
   src = fetchFromGitHub {
     owner = "executablebooks";
     repo = "markdown-it-py";
     tag = "v${version}";
-    hash = "sha256-cmjLElJA61EysTUFMVY++Kw0pI4wOIXOyCY3To9fpQc=";
+    hash = "sha256-92J9cMit2zwyjoE8G1YpwDxj+wiApQW2eUHxUOUt3as=";
   };
 
   # fix downstrem usage of markdown-it-py[linkify]
   pythonRelaxDeps = [ "linkify-it-py" ];
 
-  nativeBuildInputs = [
+  build-system = [
     flit-core
   ];
 
-  propagatedBuildInputs = [ mdurl ];
+  dependencies = [ mdurl ];
 
   nativeCheckInputs = [
     pytest-regressions
@@ -68,24 +66,27 @@ buildPythonPackage rec {
       mistletoe
       mistune
       panflute
+      # FIXME package markdown-it-pyrs
     ];
     linkify = [ linkify-it-py ];
     plugins = [ mdit-py-plugins ];
     rtd = [
-      attrs
+      mdit-py-plugins
       myst-parser
       pyyaml
       sphinx
       sphinx-copybutton
       sphinx-design
       sphinx-book-theme
+      jupyter-sphinx
+      ipykernel
     ];
   };
 
   meta = {
     description = "Markdown parser in Python";
     homepage = "https://markdown-it-py.readthedocs.io/";
-    changelog = "https://github.com/executablebooks/markdown-it-py/blob/${src.rev}/CHANGELOG.md";
+    changelog = "https://github.com/executablebooks/markdown-it-py/blob/${src.tag}/CHANGELOG.md";
     license = lib.licenses.mit;
     mainProgram = "markdown-it";
   };