diff --git a/doc/syntax.html b/doc/syntax.html
index b1a2e96..e114d6c 100644
--- a/doc/syntax.html
+++ b/doc/syntax.html
@@ -901,6 +901,45 @@ <h3>Inline attributes</h3>
 </code></pre>
 </div>
 </div>
+<p>To attach attributes to a list item, the curly braces must immediately
+follow the list marker:</p>
+<div class="example">
+<div class="djot">
+<pre><code>+{.blue} A blue list item.
+(a){.bar} Ordered list item with an attribute.</code></pre>
+</div>
+<div class="html">
+<pre><code>&lt;ul&gt;
+&lt;li class=&quot;blue&quot;&gt;
+A blue list item.
+&lt;/li&gt;
+&lt;/ul&gt;
+&lt;ol type=&quot;a&quot;&gt;
+&lt;li class=&quot;bar&quot;&gt;
+Ordered list item with an attribute.
+&lt;/li&gt;
+&lt;/ol&gt;
+</code></pre>
+</div>
+</div>
+<p>Conversely, in the following, the attributes are attached to the block
+quote:</p>
+<div class="example">
+<div class="djot">
+<pre><code>+ {.blue}
+  &gt; A blue quote.</code></pre>
+</div>
+<div class="html">
+<pre><code>&lt;ul&gt;
+&lt;li&gt;
+&lt;blockquote class=&quot;blue&quot;&gt;
+A blue quote.
+&lt;/blockquote&gt;
+&lt;/li&gt;
+&lt;/ul&gt;
+</code></pre>
+</div>
+</div>
 </section>
 </section>
 <section id="block-syntax" class="level2">
diff --git a/doc/syntax.md b/doc/syntax.md
index 945cfdc..a5262b8 100644
--- a/doc/syntax.md
+++ b/doc/syntax.md
@@ -346,6 +346,18 @@ is the same as
 
     avant{lang=fr .blue}
 
+To attach attributes to a list item, the curly braces must immediately
+follow the list marker:
+
+    +{.blue} A blue list item.
+    (a){.bar} Ordered list item with an attribute.
+
+Conversely, in the following, the attributes are attached to the block
+quote:
+
+    + {.blue}
+      > A blue quote.
+
 ## Block syntax
 
 As in commonmark, block structure can be discerned prior to inline