From a8c5da8a351e5c8b89959cbfccc1171dbc7810b9 Mon Sep 17 00:00:00 2001 From: squidfunk Date: Wed, 12 Jan 2022 22:19:48 +0100 Subject: [PATCH] Documentation --- docs/reference/annotations.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/reference/annotations.md b/docs/reference/annotations.md index 59b9f968a..eea339ab9 100644 --- a/docs/reference/annotations.md +++ b/docs/reference/annotations.md @@ -196,9 +196,16 @@ leverage the [Markdown in HTML] extension to wrap arbitrary elements with a -With this trick, annotations can also be added to blockquotes, data tables, -lists, and many other elements that are not supported by the [Attribute Lists] -extension. Furthermore, note that [code blocks follow different semantics]. +With this trick, annotations can also be added to blockquotes, lists, and many +other elements that are not supported by the [Attribute Lists] extension. +Furthermore, note that [code blocks follow different semantics]. + +!!! warning "Known limitations" + + Please note that annotations currently don't work in [data tables] as + reported in #3453, as data tables are scrollable elements and positioning + is very tricky to get right. This might be fixed in the future. [limitations]: https://python-markdown.github.io/extensions/attr_list/#limitations [code blocks follow different semantics]: code-blocks.md#adding-annotations + [data tables]: data-tables.md