Syntax and example sections

1 files changed, 10 insertions, 0 deletions

diff --git a/library/src/basics/list.rs b/library/src/basics/list.rs
index c9215a50..15b26169 100644
--- a/library/src/basics/list.rs
+++ b/library/src/basics/list.rs
@@ -8,12 +8,22 @@ use crate::text::{SpaceNode, TextNode};
 /// # Parameters
 /// - items: Content (positional, variadic)
 ///   The contents of the list items.
+///
 /// - start: NonZeroUsize (named)
 ///   Which number to start the enumeration with.
+///
 /// - tight: bool (named)
 ///   Makes the list more compact, if enabled. This looks better if the items
 ///   fit into a single line each.
 ///
+///   # Example
+///   ```
+///   #show columns.with(2)
+///   #list(tight: true)[Tight][List]
+///   #colbreak()
+///   #list(tight: false)[Wide][List]
+///   ```
+///
 /// # Tags
 /// - basics
 #[func]