diff --git a/references/chart-types/custom-charts.mdx b/references/chart-types/custom-charts.mdx
index f02550db..d4355ee5 100644
--- a/references/chart-types/custom-charts.mdx
+++ b/references/chart-types/custom-charts.mdx
@@ -944,8 +944,6 @@ The config below will output a waterfall chart with the standard Vega-Lite setti
### Map charts
-
-
Map charts are perfect for visualizing data that has geographic coordinates, such as customer locations, sales regions, or shipment routes. They combine a background map (usually countries, states, or regions) with your data points overlaid as markers.
This chart works best when you have **latitude and longitude fields** or a TopoJSON lookup with some ID or unique lookup name to plot the points on the map, and a numeric metric to adjust the size of each point or color gradient (like total sales or number of customers).
diff --git a/references/chart-types/map.mdx b/references/chart-types/map.mdx
index 6524a18b..29dc356d 100644
--- a/references/chart-types/map.mdx
+++ b/references/chart-types/map.mdx
@@ -10,6 +10,8 @@ icon: "earth-europe"
+
+

Maps display geographic data on an interactive map. They support three visualization modes: