diff --git a/gio/gfileinfo.c b/gio/gfileinfo.c
index e3578e5f0..f47eb85d9 100644
--- a/gio/gfileinfo.c
+++ b/gio/gfileinfo.c
@@ -2296,21 +2296,16 @@ matcher_optimize (GFileAttributeMatcher *matcher)
* The wildcard "*" may be used to match all keys and namespaces, or
* "namespace::*" will match all keys in a given namespace.
*
- * Examples of strings to use:
- *
- * File Attribute Matcher strings and results
- *
- * Matcher String Matches
- *
- * "*"matches all attributes.
- * "standard::is-hidden"matches only the key is-hidden in the standard namespace.
- * "standard::type,unix::*"matches the type key in the standard namespace and
- * all keys in the unix namespace.
- *
- *
+ * ## Examples of file attribute matcher strings and results
*
- * Returns: a #GFileAttributeMatcher.
- **/
+ * - `"*"`: matches all attributes.
+ * - `"standard::is-hidden"`: matches only the key is-hidden in the
+ * standard namespace.
+ * - `"standard::type,unix::*"`: matches the type key in the standard
+ * namespace and all keys in the unix namespace.
+ *
+ * Returns: a #GFileAttributeMatcher
+ */
GFileAttributeMatcher *
g_file_attribute_matcher_new (const char *attributes)
{