diff --git a/README.md b/README.md
index 6bb4983a9f..1e9077ebe4 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 <p align="center">
-  <a href="https://typer.tiangolo.com"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" alt="Typer"></a>
+  <a href="https://typer.tiangolo.com"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg#only-light" alt="Typer"></a>
+
 </p>
 <p align="center">
     <em>Typer, build great CLIs. Easy to code. Based on Python type hints.</em>
diff --git a/docs/img/logo-margin/logo-margin-white-vector.svg b/docs/img/logo-margin/logo-margin-white-vector.svg
new file mode 100644
index 0000000000..d4c32dddc4
--- /dev/null
+++ b/docs/img/logo-margin/logo-margin-white-vector.svg
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   id="svg8"
+   version="1.1"
+   viewBox="0 0 591.16894 237.29972"
+   height="237.29971mm"
+   width="591.16895mm"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
+  <defs
+     id="defs2" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <rect
+     y="1.4210855e-14"
+     x="7.1054274e-15"
+     height="237.29971"
+     width="591.16895"
+     id="rect824"
+     style="opacity:0.98000004;fill:none;fill-opacity:1;stroke-width:0.42965442" />
+  <g
+     id="g818"
+     transform="translate(-5.3444232)">
+    <path
+       style="font-weight:bold;font-size:127.57px;line-height:1.25;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';letter-spacing:0px;word-spacing:0px;fill:#ffffff;stroke-width:3.18925"
+       d="m 294.86852,68.451101 v 13.01214 H 274.07461 V 147.41693 H 258.25593 V 81.463241 h -20.79391 v -13.01214 z m 63.40204,19.00793 q -2.42383,8.41962 -4.72009,16.584099 -2.16869,8.03691 -4.59252,15.81868 -2.42383,7.6542 -5.23037,15.05326 -2.67897,7.39906 -5.86822,14.41541 -2.42383,5.1028 -4.84766,8.80233 -2.29626,3.69953 -5.23037,5.99579 -2.80654,2.42383 -6.3785,3.57196 -3.44439,1.14813 -8.16448,1.14813 -3.95467,0 -7.27149,-0.63785 -3.18925,-0.63785 -5.35794,-1.65841 l 2.93411,-13.13971 q 2.5514,1.14813 4.46495,1.53084 2.04112,0.51028 4.33738,0.51028 4.59252,0 7.39906,-3.06168 2.80654,-3.06168 4.46495,-7.27149 -5.61308,-11.22616 -11.22616,-25.64157 -5.61308,-14.54298 -10.2056,-32.020069 h 16.32896 q 1.14813,4.72009 2.5514,10.07803 1.53084,5.357939 3.18925,10.715879 1.65841,5.35794 3.44439,10.58831 1.91355,5.1028 3.8271,9.56775 1.2757,-4.46495 2.67897,-9.56775 1.40327,-5.23037 2.67897,-10.46074 1.2757,-5.35794 2.42383,-10.715879 1.2757,-5.35794 2.29626,-10.2056 z m 47.4558,30.489229 q 0,-8.03691 -3.18925,-13.13971 -3.18925,-5.230369 -9.69532,-5.230369 -1.78598,0 -3.8271,0.25514 -2.04112,0.12757 -3.44439,0.255139 v 32.91306 q 1.53084,1.02056 4.08224,1.65841 2.5514,0.63785 5.1028,0.63785 5.61308,0 8.29205,-4.46495 2.67897,-4.59252 2.67897,-12.88457 z m 15.94625,-0.51028 q 0,6.88878 -1.53084,12.757 -1.53084,5.74065 -4.46495,9.95046 -2.93411,4.08224 -7.39906,6.3785 -4.46495,2.29626 -10.33317,2.29626 -5.99579,0 -12.37429,-2.93411 v 22.57989 H 369.87919 V 89.372581 q 4.33738,-1.40327 10.58831,-2.29626 6.3785,-0.89299 12.50186,-0.89299 13.90513,0 21.30419,8.41962 7.39906,8.419619 7.39906,22.835029 z m 7.90909,0.51028 q 0,-7.90934 2.42383,-13.90513 2.42383,-5.995789 6.3785,-9.950459 3.95467,-4.08224 9.05747,-6.12336 5.1028,-2.04112 10.46074,-2.04112 13.26728,0 20.15606,7.90934 6.88878,7.781769 6.88878,22.835029 0,1.53084 -0.12757,3.18925 0,1.65841 -0.12757,2.67897 h -38.90885 q 0,5.86822 4.84766,9.31261 4.84766,3.31682 12.50186,3.31682 4.72009,0 8.9299,-1.02056 4.33738,-1.02056 7.27149,-2.04112 l 2.16869,13.39485 q -4.08224,1.40327 -8.67476,2.29626 -4.59252,1.02056 -10.33317,1.02056 -7.6542,0 -13.77756,-1.91355 -5.99579,-2.04112 -10.33317,-5.86822 -4.20981,-3.95467 -6.50607,-9.69532 -2.29626,-5.74065 -2.29626,-13.39485 z m 40.18455,-6.25093 q 0,-2.42383 -0.63785,-4.59252 -0.63785,-2.29626 -2.04112,-4.08224 -1.40327,-1.78598 -3.57196,-2.80654 -2.16869,-1.148129 -5.35794,-1.148129 -3.06168,0 -5.35794,1.020559 -2.16869,1.02056 -3.69953,2.80654 -1.40327,1.78598 -2.29626,4.08224 -0.76542,2.29626 -1.02056,4.72009 z m 75.39363,-8.29205 q -1.53084,-0.38271 -3.69953,-0.76542 -2.04112,-0.38271 -4.20981,-0.63785 -2.16869,-0.38271 -4.20981,-0.51028 -2.04112,-0.12757 -3.44439,-0.12757 -3.31682,0 -6.50607,0.38271 -3.18925,0.25514 -6.50607,1.14813 v 44.52193 H 500.76552 V 91.413701 q 6.25093,-2.29626 12.757,-3.69953 6.63364,-1.40327 15.43597,-1.40327 1.2757,0 3.57196,0.12757 2.42383,0.12757 5.1028,0.51028 2.67897,0.25514 5.35794,0.76542 2.80654,0.38271 4.97523,1.14813 z"
+       id="text861"
+       aria-label="Typer" />
+    <g
+       id="g18"
+       transform="translate(3.8685904)">
+      <rect
+         style="fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.18399"
+         id="rect17"
+         width="167.08281"
+         height="116.30997"
+         x="58.725174"
+         y="60.494881"
+         ry="12.000447" />
+      <rect
+         style="fill:#000000;fill-opacity:1;stroke:none;stroke-width:1.04929"
+         id="rect17-3"
+         width="151.51189"
+         height="100.73914"
+         x="66.510635"
+         y="68.280281"
+         ry="10.393905" />
+      <path
+         style="font-weight:bold;font-size:16.9333px;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';fill:#ffffff;stroke-width:1.31142"
+         d="m 124.52019,104.09679 v 4.05741 a 3.175,3.175 135 0 1 -3.175,3.175 l -7.33071,0 a 3.175,3.175 135 0 0 -3.175,3.175 l 0,21.70989 a 3.175,3.175 135 0 1 -3.175,3.175 h -4.05741 a 3.175,3.175 45 0 1 -3.175,-3.175 l 0,-21.70989 a 3.175,3.175 45 0 0 -3.175,-3.175 h -7.330717 a 3.175,3.175 45 0 1 -3.175,-3.175 v -4.05741 a 3.175,3.175 135 0 1 3.175,-3.175 h 31.418837 a 3.175,3.175 45 0 1 3.175,3.175 z"
+         id="text1-9-0-4-9-2-9-8-3-8-1-7-6"
+         aria-label="T"
+         transform="matrix(1.4961339,0,0,1.4961339,7.5596943,-61.118666)" />
+      <path
+         style="color:#000000;-inkscape-font-specification:'Ubuntu Mono Bold';fill:#ffffff;-inkscape-stroke:none"
+         d="m -303.02547,937.09797 14.07242,21.48374 a 5.2472832,5.2472832 90.01889 0 1 -0.002,5.7533 l -14.07252,21.45302 a 1.8573075,1.8573075 61.631824 0 0 1.55299,2.87603 l 9.93138,0 a 6.3057385,6.3057385 151.38891 0 0 5.30171,-2.89192 l 13.79332,-21.42124 a 5.3452845,5.3452845 90.017358 0 0 0.002,-5.78497 l -13.79486,-21.45218 a 6.3011967,6.3011967 28.628445 0 0 -5.29996,-2.89305 l -9.92944,0 a 1.8587724,1.8587724 118.38707 0 0 -1.55489,2.87727 z"
+         id="path4-08-1-6"
+         transform="translate(392.30819,-842.7926)" />
+    </g>
+  </g>
+</svg>
diff --git a/docs/img/logo-margin/logo-margin-white.svg b/docs/img/logo-margin/logo-margin-white.svg
new file mode 100644
index 0000000000..b758dc2481
--- /dev/null
+++ b/docs/img/logo-margin/logo-margin-white.svg
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   id="svg8"
+   version="1.1"
+   viewBox="0 0 591.16894 237.29972"
+   height="237.29971mm"
+   width="591.16895mm"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
+  <defs
+     id="defs2" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <rect
+     y="1.4210855e-14"
+     x="7.1054274e-15"
+     height="237.29971"
+     width="591.16895"
+     id="rect824"
+     style="opacity:0.98000004;fill:none;fill-opacity:1;stroke-width:0.42965442" />
+  <g
+     id="g818"
+     transform="translate(-5.3444232)">
+    <text
+       id="text861"
+       y="147.41693"
+       x="234.27277"
+       style="font-style:normal;font-weight:normal;font-size:127.57px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:3.18925"
+       xml:space="preserve"><tspan
+         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';stroke-width:3.18925;fill:#ffffff"
+         y="147.41693"
+         x="234.27277"
+         id="tspan859">Typer</tspan></text>
+    <g
+       id="g18"
+       transform="translate(3.8685904)">
+      <rect
+         style="fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.18399"
+         id="rect17"
+         width="167.08281"
+         height="116.30997"
+         x="58.725174"
+         y="60.494881"
+         ry="12.000447" />
+      <rect
+         style="fill:#000000;fill-opacity:1;stroke:none;stroke-width:1.04929"
+         id="rect17-3"
+         width="151.51189"
+         height="100.73914"
+         x="66.510635"
+         y="68.280281"
+         ry="10.393905" />
+      <path
+         style="font-weight:bold;font-size:16.9333px;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';fill:#ffffff;stroke-width:1.31142"
+         d="m 124.52019,104.09679 v 4.05741 a 3.175,3.175 135 0 1 -3.175,3.175 l -7.33071,0 a 3.175,3.175 135 0 0 -3.175,3.175 l 0,21.70989 a 3.175,3.175 135 0 1 -3.175,3.175 h -4.05741 a 3.175,3.175 45 0 1 -3.175,-3.175 l 0,-21.70989 a 3.175,3.175 45 0 0 -3.175,-3.175 h -7.330717 a 3.175,3.175 45 0 1 -3.175,-3.175 v -4.05741 a 3.175,3.175 135 0 1 3.175,-3.175 h 31.418837 a 3.175,3.175 45 0 1 3.175,3.175 z"
+         id="text1-9-0-4-9-2-9-8-3-8-1-7-6"
+         aria-label="T"
+         transform="matrix(1.4961339,0,0,1.4961339,7.5596943,-61.118666)" />
+      <path
+         style="color:#000000;-inkscape-font-specification:'Ubuntu Mono Bold';fill:#ffffff;-inkscape-stroke:none"
+         d="m -303.02547,937.09797 14.07242,21.48374 a 5.2472832,5.2472832 90.01889 0 1 -0.002,5.7533 l -14.07252,21.45302 a 1.8573075,1.8573075 61.631824 0 0 1.55299,2.87603 l 9.93138,0 a 6.3057385,6.3057385 151.38891 0 0 5.30171,-2.89192 l 13.79332,-21.42124 a 5.3452845,5.3452845 90.017358 0 0 0.002,-5.78497 l -13.79486,-21.45218 a 6.3011967,6.3011967 28.628445 0 0 -5.29996,-2.89305 l -9.92944,0 a 1.8587724,1.8587724 118.38707 0 0 -1.55489,2.87727 z"
+         id="path4-08-1-6"
+         transform="translate(392.30819,-842.7926)" />
+    </g>
+  </g>
+</svg>
diff --git a/docs/index.md b/docs/index.md
index 66a20b4853..d8a6addb5f 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -3,7 +3,10 @@
 </style>
 
 <p align="center">
-  <a href="https://typer.tiangolo.com"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" alt="Typer"></a>
+  <a href="https://typer.tiangolo.com"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg#only-light" alt="Typer"></a>
+<!-- only-mkdocs -->
+  <a href="https://typer.tiangolo.com"><img src="img/logo-margin/logo-margin-white-vector.svg#only-dark" alt="Typer"></a>
+<!-- /only-mkdocs -->
 </p>
 <p align="center">
     <em>Typer, build great CLIs. Easy to code. Based on Python type hints.</em>
diff --git a/scripts/docs.py b/scripts/docs.py
index 00364752ff..b91a10eb73 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -43,6 +43,13 @@ def generate_readme_content() -> str:
         raise RuntimeError("Couldn't find pre section (<style>) in index.md")
     frontmatter_end = match_pre.end()
     new_content = content[frontmatter_end:]
+    # Remove content between <!-- only-mkdocs --> and <!-- /only-mkdocs -->
+    new_content = re.sub(
+        r"<!-- only-mkdocs -->.*?<!-- /only-mkdocs -->",
+        "",
+        new_content,
+        flags=re.DOTALL,
+    )
     return new_content