Update docsstring and standardize formatting

altair/vegalite/v5/api.py

@@ -2726,17 +2726,17 @@ class Chart(
     data : Data
         An object describing the data source
     mark : AnyMark
-        A string describing the mark type
-        (either one of ``"bar"``, ``"circle"``, ``"square"``, ``"tick"``,``"line"``, ``"area"``, ``"point"``,
-        ``"rule"``, ``"geoshape"``, ``"text"``, ``"arc"``, ``"image"``, ``"rect"``, ``"trail"``, ``"boxplot"``,
-        ``"errorband"``, ``"errorbar"``) or a MarkDef object or a CompositeMarkDef object.
+        A ``MarkDef`` or ``CompositeMarkDef`` object, or a string describing the mark type
+        (one of ``"arc"``, ``"area"``, ``"bar"``, ``"circle"``, ``"geoshape"``, ``"image"``,
+        ``"line"``, ``"point"``, ``"rule"``, ``"rect"``, ``"square"``, ``"text"``, ``"tick"``,
+        ``"trail"``, ``"boxplot"``, ``"errorband"``, and ``"errorbar"``).
     encoding : FacetedEncoding
         A key-value mapping between encoding channels and definition of fields.
     autosize : anyOf(AutosizeType, AutoSizeParams)
         Sets how the visualization size should be determined. If a string, should be one of
-        `"pad"`, `"fit"` or `"none"`. Object values can additionally specify parameters for
-        content sizing and automatic resizing. `"fit"` is only supported for single and
-        layered views that don't use `rangeStep`.  Default value: `pad`
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify parameters for
+        content sizing and automatic resizing. ``"fit"`` is only supported for single and
+        layered views that don't use ``rangeStep``.  Default value: ``pad``
     background : string
         CSS color property to use as the background of visualization.
 
@@ -2753,13 +2753,13 @@ class Chart(
     padding : Padding
         The default visualization padding, in pixels, from the edge of the visualization
         canvas to the data rectangle.  If a number, specifies padding for all sides. If an
-        object, the value should have the format `{"left": 5, "top": 5, "right": 5,
-        "bottom": 5}` to specify padding for each side of the visualization.  Default
-        value: `5`
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.  Default
+        value: ``5``
     projection : Projection
-        An object defining properties of geographic projection.  Works with `"geoshape"`
-        marks and `"point"` or `"line"` marks that have a channel (one or more of `"X"`,
-        `"X2"`, `"Y"`, `"Y2"`) with type `"latitude"`, or `"longitude"`.
+        An object defining properties of geographic projection.  Works with ``"geoshape"``
+        marks and ``"point"`` or ``"line"`` marks that have a channel (one or more of ``"X"``,
+        ``"X2"``, ``"Y"``, ``"Y2"``) with type ``"latitude"``, or ``"longitude"``.
     selection : Mapping(required=[])
         A key-value mapping between selection names and definitions.
     title : anyOf(string, TitleParams)