Docs: document `fancy_lists` in doc/org.md (#7820)

Document the changes introduced in #7812

1 files changed, 22 insertions, 0 deletions

diff --git a/doc/org.md b/doc/org.md
index edaaa8c50..924db917b 100644
--- a/doc/org.md
+++ b/doc/org.md
@@ -368,6 +368,28 @@ provide the options line on the command line:
 
 [export setting]: https://orgmode.org/manual/Export-Settings.html
 
+`fancy_lists` extension
+=======================
+
+Org-mode has a variable `org-list-allow-alphabetical` that when
+set to `t`, allows ordered lists with single-character
+alphabetical markers. Since this variable is `nil` by default,
+alphabetical markers can be optionally enabled in Pandoc by
+enabling the `fancy_lists` extension.
+
+When `fancy_lists` is enabled, Pandoc will also parse list
+markers starting with one lowercase or uppercase alphabetical
+character, like `a.` and `D)`. Countrary to the use of this
+extension in markdown, roman numerals or the `#` placeholder
+can't be used as markers as they are not allowed in Org-mode.
+
+One additional behavior that is enabled by the `fancy_lists`
+extension is that the `.` and `)` delimiters for list markers
+will be distinguished by Pandoc. In essence, this means that when
+converting Org into formats like LaTeX, Pandoc will respect the
+type of delimiter that you used in your Org file, instead of
+always using the default delimiter for the exported format.
+
 Currently unsupported features
 ==============================