From 85d24628dc6a071ca0da211bdbc9a05ed87554fd Mon Sep 17 00:00:00 2001
From: Waylan Limberg <waylan.limberg@icloud.com>
Date: Wed, 16 Sep 2026 15:26:48 -0400
Subject: [PATCH 1/2] Document the user if attr_lists with def_list.

Ref #1123
---
 docs/changelog.md            |  1 +
 docs/extensions/attr_list.md | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)

diff --git a/docs/changelog.md b/docs/changelog.md
index 2f333b0a..2c90e24e 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -32,6 +32,7 @@ See the [Contributing Guide](contributing.md) for details.
 * Fix quadratic-time regex backtracking in `ReferenceProcessor` when a link
   reference definition has no URL, e.g. a line consisting only of `[id]:`
   followed by many trailing spaces (#798).
+* Document `attr_list` usage for `def_list` (#1123).
 
 ## [3.10.3] - 2026-07-30
 
diff --git a/docs/extensions/attr_list.md b/docs/extensions/attr_list.md
index 068c2f0f..666e0bcb 100644
--- a/docs/extensions/attr_list.md
+++ b/docs/extensions/attr_list.md
@@ -111,6 +111,23 @@ A setext style header { #setext}
 ### A hash style header ### { #hash }
 ```
 
+Similarly, when using with the [Definition List] Extension, an attribute list
+must be on the same line as the term.
+
+``` md-render
+---
+extensions: [attr_list, def_list]
+---
+Apple { #apple }
+:   Pomaceous fruit of plants of the genus Malus in
+    the family Rosaceae.
+
+Orange { #orange }
+:   The fruit of an evergreen tree of the genus Citrus.
+```
+
+[Definition List]: def_list.md
+
 !!! seealso "See Also"
 
     By default, the [Fenced Code Blocks](./fenced_code_blocks.md#attributes) extension includes limited support for

From 0d0f7e880a46afb04260b37ee0eb3b3dca8acfa1 Mon Sep 17 00:00:00 2001
From: Waylan Limberg <waylan.limberg@icloud.com>
Date: Wed, 16 Sep 2026 15:35:45 -0400
Subject: [PATCH 2/2] fix link

---
 docs/extensions/attr_list.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/extensions/attr_list.md b/docs/extensions/attr_list.md
index 666e0bcb..82f2b5fd 100644
--- a/docs/extensions/attr_list.md
+++ b/docs/extensions/attr_list.md
@@ -126,7 +126,7 @@ Orange { #orange }
 :   The fruit of an evergreen tree of the genus Citrus.
 ```
 
-[Definition List]: def_list.md
+[Definition List]: ./definition_lists.md
 
 !!! seealso "See Also"