From adb1f982528f37c9111958d1590c4407c9be4d73 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philip=20J=C3=A4genstedt?= <philip@foolip.org>
Date: Fri, 16 Jan 2026 15:20:30 +0100
Subject: [PATCH] Switch from <?marker?> to <!marker>

As suggested by @zcorpan.

There is a natural place for this in the parser already:
https://html.spec.whatwg.org/#markup-declaration-open-state
---
 patching-explainer.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/patching-explainer.md b/patching-explainer.md
index c66035a..cbc064e 100644
--- a/patching-explainer.md
+++ b/patching-explainer.md
@@ -140,7 +140,7 @@ The patches uses two markers to "emulate" append:
   <div contentname=search-results>
     <p>first result</p>
     <!-- add markers to allow for "append" -->
-    <?marker name=m1?><?marker name=m2?>
+    <!marker m1><!marker m2>
   </div>
 </template>
 
@@ -152,7 +152,7 @@ The patches uses two markers to "emulate" append:
   <div contentname=search-results>
     <p>second result</p>
     <!-- new markers are needed for the next "append". -->
-    <?marker name=m3?><?marker name=m4?>
+    <!marker m3><!marker m4>
   </div>
 </template>
 
@@ -179,7 +179,7 @@ The patches uses a single marker node:
   <div contentname=search-results>
     <p>first result</p>
     <!-- add markers to allow for "append" -->
-    <?marker name=more?>
+    <!marker more>
   </div>
 </template>
 
@@ -191,7 +191,7 @@ The patches uses a single marker node:
   <div contentname=search-results>
     <p>second result</p>
     <!-- new markers are needed for the next "append". -->
-    <?marker name=more?>
+    <!marker more>
   </div>
 </template>
 
@@ -222,9 +222,9 @@ This makes it possible to replace a `<title>` element:
 
 ```html
 <head>
-  <?marker name="metadata" start?>
+  <!marker metadata start>
   <title>Page 1</title>
-  <?marker name="metadata" end?>  
+  <!marker metadata end>
 </head>
 
 <template contentfor="metadata">
@@ -243,13 +243,13 @@ The interleaved patching example then becomes:
 
 ```html
 <!-- explicit markers are needed *inside* the element being patched. end markers are omitted -->
-<div><?marker name=product-carousel start?>Loading...</div>
-<div><?marker name=search-results start?>Loading...</div>
+<div><!marker product-carousel start>Loading...</div>
+<div><!marker search-results start>Loading...</div>
 
 <template contentfor=search-results>
   <p>first result</p>
   <!-- add markers to allow for "append" -->
-  <?marker name=search-results-more?>
+  <!marker search-results-more>
 </template>
 
 <template contentname=product-carousel>
@@ -259,7 +259,7 @@ The interleaved patching example then becomes:
 <template contentname=search-results-more>
   <p>second result</p>
   <!-- new markers are needed for the next "append". -->
-  <?marker name=search-results-more?>
+  <!marker search-results-more>
 </template>
 
 <template contentname=search-results-more>
@@ -303,10 +303,10 @@ Very initial example:
     <tr><td>static data</td></tr>
     <tr><td>static data</td></tr>
 
-    <?marker name=dyn-start?>
+    <!marker dyn-start>
     <tr><td>dynamic data 1</td></tr>
     <tr><td>dynamic data 2</td></tr>
-    <?marker name=dyn-end?>
+    <!marker dyn-end>
   </tbody>
 </table>
 
