diff --git a/docs/sources/reference/dashlist.md b/docs/sources/reference/dashlist.md
index 2baa5c0d340..f11135bb33d 100644
--- a/docs/sources/reference/dashlist.md
+++ b/docs/sources/reference/dashlist.md
@@ -11,17 +11,17 @@ page_keywords: grafana, dashlist, panel, documentation
The dashboard list panel allows you to show a list of links to other dashboards. The list can be based on a search query or dashboard tag query. You can also configure it to show your starred
dashboards.
-
+
-## Options
-
-### Mode: Starred Dashboards
+## Mode: Starred Dashboards
The `starred` dashboard selection will display starred dashboards in alphabetical order, up to the number selected in the `Limit Number to` field. As new starred dashboards are added, the Dashlist Panel will automatically update.
+
-### Mode: Search Dashboards
+
+## Mode: Search Dashboards
Dashboard lists may be configured by either a string search query or tag. On each dashboard load, the dashlist panel will re-query the dashboard list, always providing the most up to date results.
@@ -35,17 +35,16 @@ Tags | if in search mode specify dashboard tags to search for
Limit number to | Specify the maximum number of dashboards
-#### Search by string
-To search by a string, enter a search query in the `Search Options: Query:` field. Queries are non-case sensitive, and partial values are accepted. On each dashboard load, the dashlist panel will re-query the dashboard list, always providing the most up to date results of the search string.
+### Search by string
+To search by a string, enter a search query in the `Search Options: Query:` field. Queries are non-case sensitive, and partial values are accepted. On each dashboard load, the dashlist panel will re-query the dashboard list, always providing the most up to date results of the search string.
-#### Search by tag
+### Search by tag
To search by a string, enter a search query in the `Search Options: Query:` field. Queries are non-case sensitive, and partial values are accepted.
-
-When multiple tags and strings appear, the dashboard list will display those matching ALL conditions.
+> When multiple tags and strings appear, the dashboard list will display those matching ALL conditions.