docs: note hspace inline fallback needs HTML mode (sanitizer strips style attrs)

2 files changed, 4 insertions, 3 deletions

diff --git a/README b/README
index 28e1567..c001d51 100644
--- a/README
+++ b/README
@@ -127,7 +127,7 @@ def hello(name):
 ```html
 <span class="hspace-large">indented text</span>  <!-- inline: shifts this fragment right on the line -->
 <div class="hspace-large">indented block</div>    <!-- block: indents the whole line/block -->
-<span style="padding-left: 8em">custom</span>     <!-- custom offsets: use this inline -->
+<span style="padding-left: 8em">custom</span>     <!-- custom offset: needs HTML mode (inline styles are stripped by Marp's sanitizer otherwise) -->
 <!-- classes: tiny 0.5em, small 1em, medium 2em, large 3em, xlarge 4em, xxlarge 5em, hspace-6..10 (em). Replaces fragile &nbsp; runs. -->
 ```
 
diff --git a/acarp.css b/acarp.css
index a292f90..c3dcdb5 100644
--- a/acarp.css
+++ b/acarp.css
@@ -332,8 +332,9 @@ section .math {
 /* Horizontal offset utilities - add left padding.
    Works on inline spans (offset within a line) and block wrappers
    (indents the whole block). Cleaner than runs of &nbsp;.
-   For custom offsets, use an inline-padded element instead:
-     <span style="padding-left: 8em">text</span> */
+   Note: inline style="" attrs are stripped by Marp's sanitizer unless
+   HTML mode is enabled, so prefer these classes over inline padding-left.
+   For custom offsets without HTML mode there is no inline fallback. */
 .hspace-tiny { padding-left: 0.5em !important; }
 .hspace-small { padding-left: 1em !important; }
 .hspace-medium { padding-left: 2em !important; }