README.md

@@ -155,6 +155,9 @@ read replaces mentions, attachments and macros with text.
   continue, is one bullet list keeping its numbers as text.
 - A task list beside a bullet or decision list, or holding a block other than a task, joins one
   bullet list keeping its states as text: `- \[x] Done`.
+- Text that would read as a marker takes a backslash: `==` wherever it could open or close a
+  highlight, `[!…]` opening a quote, and `[x]` or `[ ]` opening any list item, since GitHub reads
+  that marker per item.
 - A node read back carries no `localId`, which Atlassian's schema requires on `taskList`,
   `taskItem` and `blockTaskItem`: mint one where the receiving site requires it.
 

spec/flavour.md

@@ -67,9 +67,7 @@ normalizes to it through the round-trip.
   matching below, which is what lets the emitter decide its own pairings.
 - Blocks separated by one blank line at document level, inside a blockquote and between CommonMark
   blocks; inside a directive container a pair holding a directive block takes none. No trailing
-  whitespace outside a code
+  whitespace outside a code block's content, single trailing newline; a document with no blocks is the empty string.
-  block's
-  content, single trailing newline; a document with no blocks is the empty string.
 
 ## Directives