Christian Moe <[email protected]> writes:

> The fact that org-html-table-default-attributes will be disregarded in
> HTML5 export is documented in the variable docstring. The docstring
> doesn't give a reason, but I don't think it needs to; documenting the
> behavior is enough.
>
> However, the fact that it will be disregarded in HTML5 export is not
> documented in the manual at [[info:org#Tables in HTML export]]. Perhaps
> it ought to be.

See the attached tentative patch.

>From 73b7706dc738565dacd9c05012084b116dfa449c Mon Sep 17 00:00:00 2001
Message-ID: <73b7706dc738565dacd9c05012084b116dfa449c.1766582900.git.yanta...@posteo.net>
From: Ihor Radchenko <[email protected]>
Date: Wed, 24 Dec 2025 14:27:01 +0100
Subject: [PATCH] org-manual: Document that `org-html-table-default-attributes'
 is ignored for HTML5 export

* doc/org-manual.org (Tables in HTML export): Add a paragraph
explaining table attributes when document type is HTML5.

Reported-by: Nikolaos Chatzikonstantinou <[email protected]>
Link: https://orgmode.org/list/[email protected]
---
 doc/org-manual.org | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index ff5a569d4..d42debe46 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -13744,6 +13744,11 @@ *** Tables in HTML export
 ,#+ATTR_HTML: :border 2 :rules all :frame border
 #+end_example
 
+Note that table attributes are deprecated in HTML5 in favor of CSS.
+When the doctype is set to HTML5 (see [[*HTML doctypes]]), Org ignores
+~org-html-table-default-attributes~.  =#+ATTR_HTML:= is still
+respected, but not recommended.
+
 The HTML export backend preserves column groupings in Org tables (see
 [[*Column Groups]]) when exporting to HTML.
 
-- 
2.52.0

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Reply via email to