Fossil SCM

Documented in /md_rules that HTML comments are disallowed under the "safe HTML" rules even though they pass the MD processor.

wyoung 2026-06-21 17:10 UTC trunk
Commit ea92c2bf9fe6e82ca8df7f2c78036800e0cf4306846ad474b980350177189f74
1 file changed +2 -1
+2 -1
--- src/markdown.md
+++ src/markdown.md
@@ -224,11 +224,12 @@
224224
225225
## Miscellaneous ##
226226
227227
> * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
228228
> * Use HTML for advanced formatting; see [Safe HTML](#safe-html) above.
229
-> * **\<!--** HTML-style comments **-->** are supported.
229
+> * **\<!--** HTML-style comments **-->** are allowed through only when
230
+> the safe-HTML rules are bypassed.
230231
> * Escape special characters (ex: **\[** **\(** **\|** **\***)
231232
> using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***).
232233
> * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
233234
> rule. Spaces and extra **-**/**\***/**_** are allowed.
234235
> * Paragraphs enclosed in **\<html\>...\</html\>** is passed through unchanged.
235236
--- src/markdown.md
+++ src/markdown.md
@@ -224,11 +224,12 @@
224
225 ## Miscellaneous ##
226
227 > * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
228 > * Use HTML for advanced formatting; see [Safe HTML](#safe-html) above.
229 > * **\<!--** HTML-style comments **-->** are supported.
 
230 > * Escape special characters (ex: **\[** **\(** **\|** **\***)
231 > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***).
232 > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
233 > rule. Spaces and extra **-**/**\***/**_** are allowed.
234 > * Paragraphs enclosed in **\<html\>...\</html\>** is passed through unchanged.
235
--- src/markdown.md
+++ src/markdown.md
@@ -224,11 +224,12 @@
224
225 ## Miscellaneous ##
226
227 > * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
228 > * Use HTML for advanced formatting; see [Safe HTML](#safe-html) above.
229 > * **\<!--** HTML-style comments **-->** are allowed through only when
230 > the safe-HTML rules are bypassed.
231 > * Escape special characters (ex: **\[** **\(** **\|** **\***)
232 > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***).
233 > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
234 > rule. Spaces and extra **-**/**\***/**_** are allowed.
235 > * Paragraphs enclosed in **\<html\>...\</html\>** is passed through unchanged.
236

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button