Merge branch 'stable'

davidism · davidism · commit 0494f0d95230 · 2025-06-11T11:19:12.000-07:00
diff --git a/README.md b/README.md
@@ -1,3 +1,5 @@
+<div align="center"><img src="https://raw.githubusercontent.com/pallets/markupsafe/refs/heads/stable/docs/_static/markupsafe-horizontal.svg" alt="" height="150"></div>
+
 # MarkupSafe
 
 MarkupSafe implements a text object that escapes characters so it is
diff --git a/docs/_static/markupsafe-horizontal.svg b/docs/_static/markupsafe-horizontal.svg
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 460 170" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g id="Name">
+        <path d="M235.169,78.731l-6.01,12.679c-0.877,1.69 -1.965,2.535 -3.264,2.535c-1.299,0 -2.387,-0.892 -3.264,-2.676l-6.104,-12.538l0,19.957l-6.527,0l0,-33.433l6.433,-0l9.439,19.299l9.391,-19.299l6.433,-0l0,33.433l-6.527,0l0,-19.957Z" style="fill-rule:nonzero;"/>
+        <path d="M266.536,98.688l-4.085,0l-1.878,-3.24l-6.527,3.522c-3.632,-0 -6.073,-1.315 -7.325,-3.945c-0.627,-1.283 -1.057,-2.668 -1.292,-4.155c-0.235,-1.487 -0.352,-3.037 -0.352,-4.649c0,-1.612 0.016,-2.802 0.047,-3.569c0.031,-0.767 0.11,-1.659 0.235,-2.676c0.125,-1.018 0.305,-1.871 0.54,-2.56c0.235,-0.688 0.571,-1.4 1.009,-2.136c0.439,-0.736 0.971,-1.323 1.597,-1.761c1.409,-0.97 3.24,-1.456 5.494,-1.456l6.433,0l6.104,-0.375l0,27Zm-6.104,-8.546l0,-12.585l-4.649,0c-1.722,0 -2.919,0.658 -3.592,1.972c-0.673,1.315 -1.01,3.28 -1.01,5.894c0,2.614 0.321,4.453 0.963,5.517c0.642,1.064 1.855,1.597 3.639,1.597l4.649,-2.395Z" style="fill-rule:nonzero;"/>
+        <path d="M287.385,71.969l-1.69,6.011c-0.47,-0.188 -1.002,-0.282 -1.597,-0.282c-1.565,0 -3.49,0.673 -5.775,2.019l-0,18.971l-6.105,0l0,-26.813l4.555,0l1.409,2.348l6.48,-2.676c0.313,-0.032 0.736,-0.047 1.268,-0.047c0.532,-0 1.017,0.156 1.455,0.469Z" style="fill-rule:nonzero;"/>
+        <path d="M314.527,98.688l-7.326,0l-7.043,-9.485l-2.677,3.803l0,5.682l-6.104,0l-0,-35.312l6.104,0l0,22.305l8.546,-12.726l6.903,0l-8.781,12.022l10.378,13.711Z" style="fill-rule:nonzero;"/>
+        <path d="M337.77,98.688l-4.554,0l-1.409,-3.193l-7.513,3.475c-2.098,-0 -3.921,-0.775 -5.471,-2.325c-1.549,-1.549 -2.324,-3.811 -2.324,-6.785l-0,-17.985l6.104,0l0,16.67c0,2.974 1.19,4.461 3.569,4.461l5.494,-2.958l0,-18.173l6.104,0l0,26.813Z" style="fill-rule:nonzero;"/>
+        <path d="M366.039,84.554c-0,6.981 -1.8,11.442 -5.4,13.383c-1.472,0.782 -3.272,1.174 -5.4,1.174l-4.508,-2.912l-0,10.472l-6.105,-0l0,-34.608l12.021,0c3.632,0 6.105,1.026 7.419,3.076c1.315,2.05 1.973,5.189 1.973,9.415Zm-6.105,0.939c0,-5.29 -1.69,-7.936 -5.071,-7.936l-4.132,0l-0,12.444l4.132,2.676c1.816,0 3.115,-0.571 3.897,-1.713c0.783,-1.143 1.174,-2.967 1.174,-5.471Z" style="fill-rule:nonzero;"/>
+        <path d="M393.931,88.827c0,3.162 -1.158,5.643 -3.475,7.443c-2.316,1.8 -5.274,2.7 -8.874,2.7c-2.849,-0 -5.604,-0.783 -8.265,-2.348c-1.315,-0.814 -2.395,-1.964 -3.24,-3.451c-0.845,-1.487 -1.268,-3.186 -1.268,-5.095l5.917,-0.282c-0,1.69 0.72,3.005 2.16,3.944c1.44,0.939 3.036,1.409 4.789,1.409c3.914,0 5.87,-1.377 5.87,-4.132c0,-2.254 -1.33,-3.585 -3.991,-3.992l-5.447,-0.563c-2.724,-0.407 -4.884,-1.377 -6.48,-2.911c-1.597,-1.534 -2.395,-3.741 -2.395,-6.621c-0,-2.88 1.142,-5.26 3.428,-7.138c2.285,-1.878 5.173,-2.817 8.663,-2.817c3.491,-0 6.3,0.884 8.429,2.653c2.129,1.769 3.193,4.046 3.193,6.832l-5.823,0.282c-0.532,-2.724 -2.363,-4.085 -5.494,-4.085c-1.909,-0 -3.404,0.407 -4.484,1.22c-1.08,0.814 -1.62,1.777 -1.62,2.888c0,1.112 0.391,1.988 1.174,2.63c0.783,0.642 1.753,1.041 2.911,1.197l5.353,0.564c5.98,0.814 8.969,4.038 8.969,9.673Z" style="fill-rule:nonzero;"/>
+        <path d="M417.128,98.688l-4.085,0l-1.878,-3.24l-6.528,3.522c-3.631,-0 -6.073,-1.315 -7.325,-3.945c-0.626,-1.283 -1.056,-2.668 -1.291,-4.155c-0.235,-1.487 -0.352,-3.037 -0.352,-4.649c-0,-1.612 0.015,-2.802 0.047,-3.569c0.031,-0.767 0.109,-1.659 0.234,-2.676c0.126,-1.018 0.306,-1.871 0.54,-2.56c0.235,-0.688 0.572,-1.4 1.01,-2.136c0.438,-0.736 0.97,-1.323 1.597,-1.761c1.408,-0.97 3.24,-1.456 5.494,-1.456l6.433,0l6.104,-0.375l0,27Zm-6.104,-8.546l-0,-12.585l-4.649,0c-1.722,0 -2.919,0.658 -3.592,1.972c-0.673,1.315 -1.01,3.28 -1.01,5.894c0,2.614 0.321,4.453 0.963,5.517c0.641,1.064 1.855,1.597 3.639,1.597l4.649,-2.395Z" style="fill-rule:nonzero;"/>
+        <path d="M435.113,77.557l-4.978,0l0,21.131l-6.104,0l-0,-21.131l-2.536,0l0,-4.648l2.536,-0l-0,-2.583c-0,-1.91 0.61,-3.553 1.831,-4.931c1.221,-1.377 2.99,-2.066 5.306,-2.066l3.945,0l-0,5.166l-2.865,-0c-1.408,-0 -2.113,0.735 -2.113,2.207l0,2.207l4.978,-0l-0,4.648Z" style="fill-rule:nonzero;"/>
+        <path d="M459.906,86.714l-15.637,-0c0,2.442 0.384,4.226 1.151,5.353c0.767,1.127 2.309,1.691 4.625,1.691c1.503,-0 2.614,-0.478 3.334,-1.433c0.72,-0.954 1.08,-1.87 1.08,-2.747l5.494,0c0,3.35 -0.9,5.807 -2.7,7.373c-1.8,1.565 -4.179,2.347 -7.137,2.347c-2.959,0 -5.252,-0.422 -6.88,-1.267c-3.349,-1.722 -5.024,-6.293 -5.024,-13.712c-0,-4.414 0.955,-7.646 2.864,-9.697c1.91,-2.05 4.821,-3.075 8.734,-3.075c6.793,-0 10.19,3.772 10.19,11.316c0,0.814 -0.031,2.098 -0.094,3.851Zm-15.496,-4.179l10.049,-0c0,-2.066 -0.391,-3.569 -1.174,-4.508c-0.782,-0.939 -1.98,-1.409 -3.592,-1.409c-1.612,0 -2.896,0.478 -3.851,1.432c-0.954,0.955 -1.432,2.45 -1.432,4.485Z" style="fill-rule:nonzero;"/>
+    </g>
+    <g id="Icon">
+        <path id="Box" d="M170,17l0,136c0,9.383 -7.617,17 -17,17l-136,0c-9.383,0 -17,-7.617 -17,-17l0,-136c0,-9.383 7.617,-17 17,-17l136,0c9.383,0 17,7.617 17,17Z" style="fill:url(#_Linear1);"/>
+        <path id="Shadow" d="M170,91.128l0,61.872c0,9.383 -7.617,17 -17,17l-60.2,0l-42.608,-42.609c0.226,0.207 0.482,0.379 0.76,0.51c2.668,1.276 5.336,2.436 8.004,3.364c1.624,0.58 3.306,-0.58 3.306,-2.32l0,-48.085c0,-1.798 1.915,-3.016 3.539,-2.204l18.155,9.048c0.696,0.348 1.508,0.348 2.204,0l17.865,-9.106c1.624,-0.812 3.539,0.348 3.597,2.204l0.058,48.027c-0,1.682 1.682,2.9 3.306,2.32c2.61,-0.986 5.22,-2.03 7.83,-3.306c0.986,-0.464 1.74,-1.45 1.914,-2.61l7.309,-44.199c0.058,-0.29 0.058,-0.696 -0,-1.044l-5.394,-35.267c-0.108,-0.718 -0.439,-1.37 -0.922,-1.872l48.277,48.277Zm-85.928,-13.516l-19.431,-9.339c-0.87,-0.406 -1.392,-1.276 -1.392,-2.204l-0,-5.394c-0,-1.799 1.914,-3.017 3.538,-2.205l17.227,8.585c0.696,0.348 1.508,0.348 2.204,-0l16.879,-8.585c1.624,-0.812 3.538,0.348 3.596,2.205l0,5.742c0,0.928 -0.522,1.798 -1.392,2.204l-19.141,9.049c-0.638,0.29 -1.392,0.29 -2.088,-0.058Zm-0,21.171l-6.845,-3.306c-1.624,-0.754 -3.538,0.406 -3.538,2.204l0,35.324c0,1.218 0.928,2.262 2.146,2.437c6.091,0.754 12.181,0.754 18.272,-0.058c1.218,-0.175 2.146,-1.219 2.146,-2.437l-0,-35.092c-0,-1.798 -1.856,-2.958 -3.48,-2.204l-6.613,3.132c-0.638,0.29 -1.392,0.29 -2.088,0Z" style="fill:#474f47;"/>
+        <g id="Icon1" serif:id="Icon">
+            <path d="M84.072,98.783l-6.845,-3.306c-1.624,-0.754 -3.538,0.406 -3.538,2.204l0,35.324c0,1.218 0.928,2.262 2.146,2.437c6.091,0.754 12.181,0.754 18.272,-0.058c1.218,-0.175 2.146,-1.219 2.146,-2.437l-0,-35.092c-0,-1.798 -1.856,-2.958 -3.48,-2.204l-6.613,3.132c-0.638,0.29 -1.392,0.29 -2.088,0Z" style="fill:#fff;"/>
+            <path d="M128.039,79.99l-5.394,-35.267c-0.175,-1.16 -0.929,-2.146 -1.973,-2.61c-23.781,-10.788 -47.563,-10.846 -71.344,0c-1.044,0.464 -1.798,1.45 -1.973,2.61l-5.394,35.267c-0.058,0.348 -0.058,0.754 0,1.102l7.135,44.199c0.174,1.16 0.87,2.146 1.856,2.61c2.668,1.276 5.336,2.436 8.004,3.364c1.624,0.58 3.306,-0.58 3.306,-2.32l0,-48.085c0,-1.798 1.915,-3.016 3.539,-2.204l18.155,9.048c0.696,0.348 1.508,0.348 2.204,0l17.865,-9.106c1.624,-0.812 3.539,0.348 3.597,2.204l0.058,48.027c-0,1.682 1.682,2.9 3.306,2.32c2.61,-0.986 5.22,-2.03 7.83,-3.306c0.986,-0.464 1.74,-1.45 1.914,-2.61l7.309,-44.199c0.058,-0.29 0.058,-0.696 -0,-1.044Zm-43.967,-2.378l-19.431,-9.339c-0.87,-0.406 -1.392,-1.276 -1.392,-2.204l-0,-5.394c-0,-1.799 1.914,-3.017 3.538,-2.205l17.227,8.585c0.696,0.348 1.508,0.348 2.204,-0l16.879,-8.585c1.624,-0.812 3.538,0.348 3.596,2.205l0,5.742c0,0.928 -0.522,1.798 -1.392,2.204l-19.141,9.049c-0.638,0.29 -1.392,0.29 -2.088,-0.058Z" style="fill:#fff;"/>
+        </g>
+    </g>
+    <defs>
+        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1.04095e-14,170,-170,1.04095e-14,90.9806,0)"><stop offset="0" style="stop-color:#bad1ba;stop-opacity:1"/><stop offset="1" style="stop-color:#657265;stop-opacity:1"/></linearGradient>
+    </defs>
+</svg>
diff --git a/docs/_static/markupsafe-icon.svg b/docs/_static/markupsafe-icon.svg
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 500 500" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <rect id="Icon" x="0" y="0" width="500" height="500" style="fill:none;"/>
+    <clipPath id="_clip1">
+        <rect x="0" y="0" width="500" height="500"/>
+    </clipPath>
+    <g clip-path="url(#_clip1)">
+        <path d="M245.451,317.564l-33.552,-16.207c-7.961,-3.696 -17.344,1.99 -17.344,10.805l0,173.158c0,5.971 4.549,11.089 10.52,11.942c29.855,3.697 59.71,3.697 89.565,-0.284c5.971,-0.853 10.521,-5.971 10.521,-11.942l-0,-172.021c-0,-8.815 -9.099,-14.501 -17.06,-10.805l-32.414,15.354c-3.128,1.422 -6.824,1.422 -10.236,0Z" style="fill:#9fb19e;"/>
+        <path d="M460.975,225.44l-26.443,-172.874c-0.853,-5.687 -4.549,-10.52 -9.667,-12.795c-116.577,-52.886 -233.153,-53.17 -349.73,0c-5.118,2.275 -8.814,7.108 -9.667,12.795l-26.443,172.874c-0.284,1.706 -0.284,3.697 0,5.403l34.973,216.661c0.853,5.687 4.265,10.52 9.099,12.795c13.079,6.255 26.158,11.942 39.238,16.491c7.961,2.844 16.207,-2.843 16.207,-11.373l-0,-235.712c-0,-8.814 9.383,-14.785 17.344,-10.804l88.996,44.356c3.412,1.706 7.393,1.706 10.805,-0l87.574,-44.641c7.961,-3.98 17.344,1.706 17.629,10.805l0.284,235.427c0,8.246 8.246,14.217 16.207,11.374c12.795,-4.834 25.59,-9.952 38.385,-16.207c4.834,-2.275 8.53,-7.109 9.383,-12.795l35.826,-216.662c0.284,-1.421 0.284,-3.412 -0,-5.118Zm-215.524,-11.657l-95.252,-45.778c-4.265,-1.99 -6.824,-6.255 -6.824,-10.805l0,-26.442c0,-8.815 9.383,-14.786 17.345,-10.805l84.446,42.081c3.412,1.706 7.393,1.706 10.805,0l82.741,-42.081c7.961,-3.981 17.344,1.706 17.628,10.805l0,28.148c0,4.55 -2.559,8.815 -6.824,10.805l-93.829,44.356c-3.128,1.422 -6.824,1.422 -10.236,-0.284Z" style="fill:#9fb19e;"/>
+    </g>
+</svg>
diff --git a/docs/_static/markupsafe-vertical.svg b/docs/_static/markupsafe-vertical.svg
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 250 334" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g id="Name">
+        <path d="M25.169,305.402l-6.01,12.678c-0.877,1.691 -1.965,2.536 -3.264,2.536c-1.299,0 -2.387,-0.892 -3.264,-2.676l-6.104,-12.538l0,19.957l-6.527,-0l0,-33.434l6.433,0l9.439,19.3l9.391,-19.3l6.433,0l0,33.434l-6.527,-0l0,-19.957Z" style="fill-rule:nonzero;"/>
+        <path d="M56.536,325.359l-4.085,-0l-1.878,-3.24l-6.527,3.521c-3.632,0 -6.073,-1.314 -7.325,-3.944c-0.627,-1.283 -1.057,-2.669 -1.292,-4.156c-0.235,-1.487 -0.352,-3.036 -0.352,-4.648c0,-1.613 0.016,-2.802 0.047,-3.569c0.031,-0.767 0.11,-1.659 0.235,-2.677c0.125,-1.017 0.305,-1.87 0.54,-2.559c0.235,-0.689 0.571,-1.401 1.009,-2.136c0.439,-0.736 0.971,-1.323 1.597,-1.761c1.409,-0.971 3.24,-1.456 5.494,-1.456l6.433,0l6.104,-0.376l0,27.001Zm-6.104,-8.546l0,-12.585l-4.649,0c-1.722,0 -2.919,0.657 -3.592,1.972c-0.673,1.315 -1.01,3.279 -1.01,5.893c0,2.614 0.321,4.453 0.963,5.518c0.642,1.064 1.855,1.596 3.639,1.596l4.649,-2.394Z" style="fill-rule:nonzero;"/>
+        <path d="M77.385,298.64l-1.69,6.011c-0.47,-0.188 -1.002,-0.282 -1.597,-0.282c-1.565,-0 -3.49,0.673 -5.775,2.019l-0,18.971l-6.105,-0l0,-26.813l4.555,0l1.409,2.348l6.48,-2.676c0.313,-0.032 0.736,-0.047 1.268,-0.047c0.532,-0 1.017,0.156 1.455,0.469Z" style="fill-rule:nonzero;"/>
+        <path d="M104.527,325.359l-7.326,-0l-7.043,-9.486l-2.677,3.804l0,5.682l-6.104,-0l-0,-35.312l6.104,-0l0,22.305l8.546,-12.726l6.903,0l-8.781,12.021l10.378,13.712Z" style="fill-rule:nonzero;"/>
+        <path d="M127.77,325.359l-4.554,-0l-1.409,-3.193l-7.513,3.474c-2.098,0 -3.921,-0.774 -5.471,-2.324c-1.549,-1.549 -2.324,-3.811 -2.324,-6.785l-0,-17.985l6.104,0l0,16.67c0,2.974 1.19,4.461 3.569,4.461l5.494,-2.958l0,-18.173l6.104,0l0,26.813Z" style="fill-rule:nonzero;"/>
+        <path d="M156.039,311.225c-0,6.981 -1.8,11.442 -5.4,13.382c-1.472,0.783 -3.272,1.174 -5.4,1.174l-4.508,-2.911l-0,10.471l-6.105,0l0,-34.607l12.021,0c3.632,0 6.105,1.025 7.419,3.076c1.315,2.05 1.973,5.188 1.973,9.415Zm-6.105,0.939c0,-5.291 -1.69,-7.936 -5.071,-7.936l-4.132,0l-0,12.444l4.132,2.676c1.816,0 3.115,-0.571 3.897,-1.714c0.783,-1.142 1.174,-2.966 1.174,-5.47Z" style="fill-rule:nonzero;"/>
+        <path d="M183.931,315.498c0,3.162 -1.158,5.642 -3.475,7.442c-2.316,1.8 -5.274,2.7 -8.874,2.7c-2.849,0 -5.604,-0.782 -8.265,-2.347c-1.315,-0.814 -2.395,-1.965 -3.24,-3.452c-0.845,-1.487 -1.268,-3.185 -1.268,-5.095l5.917,-0.281c-0,1.69 0.72,3.005 2.16,3.944c1.44,0.939 3.036,1.409 4.789,1.409c3.914,-0 5.87,-1.378 5.87,-4.132c0,-2.254 -1.33,-3.585 -3.991,-3.992l-5.447,-0.563c-2.724,-0.407 -4.884,-1.378 -6.48,-2.912c-1.597,-1.534 -2.395,-3.741 -2.395,-6.621c-0,-2.88 1.142,-5.259 3.428,-7.137c2.285,-1.878 5.173,-2.817 8.663,-2.817c3.491,-0 6.3,0.884 8.429,2.653c2.129,1.768 3.193,4.046 3.193,6.832l-5.823,0.282c-0.532,-2.724 -2.363,-4.086 -5.494,-4.086c-1.909,0 -3.404,0.407 -4.484,1.221c-1.08,0.814 -1.62,1.777 -1.62,2.888c0,1.111 0.391,1.988 1.174,2.63c0.783,0.641 1.753,1.041 2.911,1.197l5.353,0.564c5.98,0.813 8.969,4.038 8.969,9.673Z" style="fill-rule:nonzero;"/>
+        <path d="M207.128,325.359l-4.085,-0l-1.878,-3.24l-6.528,3.521c-3.631,0 -6.073,-1.314 -7.325,-3.944c-0.626,-1.283 -1.056,-2.669 -1.291,-4.156c-0.235,-1.487 -0.352,-3.036 -0.352,-4.648c-0,-1.613 0.015,-2.802 0.047,-3.569c0.031,-0.767 0.109,-1.659 0.234,-2.677c0.126,-1.017 0.306,-1.87 0.54,-2.559c0.235,-0.689 0.572,-1.401 1.01,-2.136c0.438,-0.736 0.97,-1.323 1.597,-1.761c1.408,-0.971 3.24,-1.456 5.494,-1.456l6.433,0l6.104,-0.376l0,27.001Zm-6.104,-8.546l-0,-12.585l-4.649,0c-1.722,0 -2.919,0.657 -3.592,1.972c-0.673,1.315 -1.01,3.279 -1.01,5.893c0,2.614 0.321,4.453 0.963,5.518c0.641,1.064 1.855,1.596 3.639,1.596l4.649,-2.394Z" style="fill-rule:nonzero;"/>
+        <path d="M225.113,304.228l-4.978,0l0,21.131l-6.104,-0l-0,-21.131l-2.536,0l0,-4.649l2.536,0l-0,-2.582c-0,-1.91 0.61,-3.553 1.831,-4.931c1.221,-1.377 2.99,-2.066 5.306,-2.066l3.945,-0l-0,5.165l-2.865,0c-1.408,0 -2.113,0.736 -2.113,2.207l0,2.207l4.978,0l-0,4.649Z" style="fill-rule:nonzero;"/>
+        <path d="M249.906,313.385l-15.637,-0c0,2.441 0.384,4.226 1.151,5.353c0.767,1.127 2.309,1.69 4.625,1.69c1.503,0 2.614,-0.477 3.334,-1.432c0.72,-0.955 1.08,-1.87 1.08,-2.747l5.494,0c0,3.35 -0.9,5.807 -2.7,7.372c-1.8,1.566 -4.179,2.348 -7.137,2.348c-2.959,0 -5.252,-0.422 -6.88,-1.268c-3.349,-1.721 -5.024,-6.292 -5.024,-13.711c-0,-4.414 0.955,-7.646 2.864,-9.697c1.91,-2.05 4.821,-3.075 8.734,-3.075c6.793,-0 10.19,3.772 10.19,11.316c-0,0.814 -0.031,2.098 -0.094,3.851Zm-15.496,-4.18l10.049,0c0,-2.066 -0.391,-3.568 -1.174,-4.507c-0.782,-0.94 -1.98,-1.409 -3.592,-1.409c-1.612,-0 -2.896,0.477 -3.851,1.432c-0.954,0.955 -1.432,2.45 -1.432,4.484Z" style="fill-rule:nonzero;"/>
+    </g>
+    <g id="Icon">
+        <path id="Box" d="M250,25l0,200c0,13.798 -11.202,25 -25,25l-200,0c-13.798,0 -25,-11.202 -25,-25l0,-200c0,-13.798 11.202,-25 25,-25l200,0c13.798,0 25,11.202 25,25Z" style="fill:url(#_Linear1);"/>
+        <path id="Shadow" d="M250,134.012l0,90.988c0,13.798 -11.202,25 -25,25l-88.529,0l-62.66,-62.66c0.334,0.304 0.709,0.557 1.118,0.75c3.924,1.876 7.848,3.582 11.771,4.947c2.389,0.853 4.862,-0.853 4.862,-3.412l0,-70.713c0,-2.645 2.815,-4.436 5.204,-3.242l26.699,13.307c1.023,0.512 2.217,0.512 3.241,-0l26.272,-13.392c2.389,-1.194 5.204,0.512 5.289,3.241l0.085,70.629c0,2.473 2.474,4.265 4.862,3.412c3.839,-1.451 7.677,-2.986 11.516,-4.863c1.45,-0.682 2.559,-2.132 2.815,-3.838l10.747,-64.999c0.086,-0.426 0.086,-1.023 0,-1.535l-7.932,-51.862c-0.159,-1.057 -0.645,-2.015 -1.356,-2.754l70.996,70.996Zm-126.365,-19.877l-28.575,-13.733c-1.28,-0.598 -2.047,-1.877 -2.047,-3.242l-0,-7.933c-0,-2.644 2.814,-4.435 5.203,-3.241l25.334,12.624c1.024,0.512 2.218,0.512 3.241,0l24.823,-12.624c2.388,-1.194 5.203,0.512 5.288,3.241l0,8.445c0,1.365 -0.768,2.644 -2.047,3.241l-28.149,13.307c-0.938,0.427 -2.047,0.427 -3.071,-0.085Zm0,31.134l-10.065,-4.862c-2.389,-1.109 -5.203,0.597 -5.203,3.242l-0,51.947c-0,1.791 1.364,3.327 3.156,3.583c8.956,1.109 17.913,1.109 26.869,-0.086c1.791,-0.256 3.156,-1.791 3.156,-3.582l0,-51.607c0,-2.644 -2.729,-4.35 -5.118,-3.241l-9.724,4.606c-0.938,0.427 -2.047,0.427 -3.071,0Z" style="fill:#474f47;"/>
+        <g id="Icon1" serif:id="Icon">
+            <path d="M123.635,145.269l-10.065,-4.862c-2.389,-1.109 -5.203,0.597 -5.203,3.242l-0,51.947c-0,1.791 1.364,3.327 3.156,3.583c8.956,1.109 17.913,1.109 26.869,-0.086c1.791,-0.256 3.156,-1.791 3.156,-3.582l0,-51.607c0,-2.644 -2.729,-4.35 -5.118,-3.241l-9.724,4.606c-0.938,0.427 -2.047,0.427 -3.071,0Z" style="fill:#fff;"/>
+            <path d="M188.292,117.632l-7.932,-51.862c-0.256,-1.706 -1.365,-3.156 -2.901,-3.839c-34.973,-15.865 -69.945,-15.951 -104.918,0c-1.536,0.683 -2.645,2.133 -2.901,3.839l-7.932,51.862c-0.086,0.512 -0.086,1.109 -0,1.621l10.491,64.998c0.256,1.706 1.28,3.156 2.73,3.839c3.924,1.876 7.848,3.582 11.771,4.947c2.389,0.853 4.862,-0.853 4.862,-3.412l0,-70.713c0,-2.645 2.815,-4.436 5.204,-3.242l26.699,13.307c1.023,0.512 2.217,0.512 3.241,-0l26.272,-13.392c2.389,-1.194 5.204,0.512 5.289,3.241l0.085,70.629c0,2.473 2.474,4.265 4.862,3.412c3.839,-1.451 7.677,-2.986 11.516,-4.863c1.45,-0.682 2.559,-2.132 2.815,-3.838l10.747,-64.999c0.086,-0.426 0.086,-1.023 0,-1.535Zm-64.657,-3.497l-28.575,-13.733c-1.28,-0.598 -2.047,-1.877 -2.047,-3.242l-0,-7.933c-0,-2.644 2.814,-4.435 5.203,-3.241l25.334,12.624c1.024,0.512 2.218,0.512 3.241,0l24.823,-12.624c2.388,-1.194 5.203,0.512 5.288,3.241l0,8.445c0,1.365 -0.768,2.644 -2.047,3.241l-28.149,13.307c-0.938,0.427 -2.047,0.427 -3.071,-0.085Z" style="fill:#fff;"/>
+        </g>
+    </g>
+    <defs>
+        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1.53081e-14,250,-250,1.53081e-14,133.795,0)"><stop offset="0" style="stop-color:#bad1ba;stop-opacity:1"/><stop offset="1" style="stop-color:#657265;stop-opacity:1"/></linearGradient>
+    </defs>
+</svg>
diff --git a/docs/conf.py b/docs/conf.py
@@ -47,5 +47,8 @@
     "**": ["localtoc.html", "relations.html", "searchbox.html", "ethicalads.html"],
 }
 singlehtml_sidebars = {"index": ["project.html", "localtoc.html", "ethicalads.html"]}
+html_static_path = ["_static"]
+html_favicon = "_static/markupsafe-icon.svg"
+html_logo = "_static/markupsafe-vertical.svg"
 html_title = f"MarkupSafe Documentation ({version})"
 html_show_sourcelink = False
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,8 +1,13 @@
 .. currentmodule:: markupsafe
+.. rst-class:: hide-header
 
 MarkupSafe
 ==========
 
+.. image:: _static/markupsafe-horizontal.svg
+    :align: center
+    :height: 200px
+
 MarkupSafe escapes characters so text is safe to use in HTML and XML.
 Characters that have special meanings are replaced so that they display
 as the actual characters. This mitigates injection attacks, meaning

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<div align="center"><img src="https://raw.githubusercontent.com/pallets/markupsafe/refs/heads/stable/docs/_static/markupsafe-horizontal.svg" alt="" height="150"></div>`
	`2`	`+`
`1`	`3`	`# MarkupSafe`
`2`	`4`
`3`	`5`	`MarkupSafe implements a text object that escapes characters so it is`
Original file line number	Diff line number	Diff line change
`@@ -47,5 +47,8 @@`
`47`	`47`	`"**": ["localtoc.html", "relations.html", "searchbox.html", "ethicalads.html"],`
`48`	`48`	`}`
`49`	`49`	`singlehtml_sidebars = {"index": ["project.html", "localtoc.html", "ethicalads.html"]}`
	`50`	`+html_static_path = ["_static"]`
	`51`	`+html_favicon = "_static/markupsafe-icon.svg"`
	`52`	`+html_logo = "_static/markupsafe-vertical.svg"`
`50`	`53`	`html_title = f"MarkupSafe Documentation ({version})"`
`51`	`54`	`html_show_sourcelink = False`