diff --git a/doc/impl-thoughts/html-messages.md b/doc/impl-thoughts/html-messages.md
new file mode 100644
index 00000000..f217c82d
--- /dev/null
+++ b/doc/impl-thoughts/html-messages.md
@@ -0,0 +1,4 @@
+message model:
+ - paragraphs (p, h1, code block, quote, ...)
+ - lines
+ - parts (inline markup), which can be recursive