From 62382f4e1be85ea20633eef82dfce6a5bccda6ff Mon Sep 17 00:00:00 2001 From: "Kyle J. McKay" Date: Tue, 2 Mar 2021 23:00:43 -0700 Subject: [PATCH] Markdown.pl: add a help comment about literal html tags Signed-off-by: Kyle J. McKay --- Markdown.pl | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/Markdown.pl b/Markdown.pl index f8e212b..672c8f1 100755 --- a/Markdown.pl +++ b/Markdown.pl @@ -5030,6 +5030,34 @@ the usage and options are shown. =back +=head1 HTML CONTENT + +Markdown format documents are intended to be human readable without the use +of XML-like markup. + +Nevertheless, html content can be included verbatim provided that the tags +used are limited to those of the HTML 4 specification and only those tags +that represent body content -- scripting tags and attributes are not allowed. + +The final version of the HTML specification (including a DTD) can be found +here: + +=over + +=over + +=item L + +=back + +=back + +Note that attempts to use any of the new tags from the "HTML Living Standard" +will simply result in them being escaped into literal text. + +Stick to markdown-format text or HTML 4 tags to avoid unexpected output. + + =head1 PERL MODULE Markdown can be used as a Perl module and can be "use"d like so: