From 09087097b5cea8b4158886e05adc7e023be92584 Mon Sep 17 00:00:00 2001
From: josh rotenberg <joshrotenberg@users.noreply.github.com>
Date: Sat, 18 Dec 2021 15:50:51 -0800
Subject: [PATCH] add more sections here

---
 guide/src/format/markdown.md | 58 +++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/guide/src/format/markdown.md b/guide/src/format/markdown.md
index b23c2a99..7e807af7 100644
--- a/guide/src/format/markdown.md
+++ b/guide/src/format/markdown.md
@@ -8,7 +8,63 @@ this documentation, but below is a high level overview of some of the basics. Fo
 
 ## Text and Paragraphs
 
-## Titles
+Text is rendered relatively predictably: 
+
+```markdown
+Here is a line of text.
+
+This is a new line.
+```
+
+Will look like you might expect:
+
+Here is a line of text.
+
+This is a new line.
+
+## Headings
+
+Headings use the `#` marker and should be on a line by themselves. More `#` mean smaller headings:
+
+```markdown
+### A heading 
+
+Some text.
+
+#### A smaller heading 
+
+More text.
+```
+
+### A heading 
+
+Some text.
+
+#### A smaller heading 
+
+More text.
+
+## Lists
+
+Lists can be unordered or ordered. Ordered lists will order automatically:
+
+```markdown
+* milk
+* eggs
+* butter
+
+1. carrots
+1. celery
+1. radishes
+```
+
+* milk
+* eggs
+* butter
+
+1. carrots
+1. celery
+1. radishes
 
 ## Links