 ;; When applicable, commands that specifically act on the region even
 ;; outside of Transient Mark mode have the same keybinding as the with
 ;; the exception of an additional `C-` prefix.  For example,
-;; `markdown-insert-blockquote` is bound to `C-c C-s b` and only acts on
-;; the region in Transient Mark mode while `markdown-blockquote-region`
+;; `markdown-insert-blockquote' is bound to `C-c C-s b` and only acts on
+;; the region in Transient Mark mode while `markdown-blockquote-region'
 ;; is bound to `C-c C-s C-b` and always applies to the region (when
 ;; nonempty).
+;;
+;; markdown-mode attempts to be flexible in how it handles
+;; indentation.  When you press `TAB` repeatedly, the point will cycle
+;; through several possible indentation levels corresponding to things
+;; you might have in mind when you press `RET` at the end of a line or
+;; `TAB`.  For example, you may want to start a new list item,
+;; continue a list item with hanging indentation, indent for a nested
+;; pre block, and so on.
 ;;
 ;; markdown-mode supports outline-minor-mode as well as org-mode-style
 ;; visibility cycling for atx- or hash-style headers.  There are two


(defvar markdown-math-face 'markdown-math-face
  "Face name to use for LaTeX expressions.")


(defgroup markdown-faces nil
  "Faces used in Markdown Mode"

;;     `C-c C-c m` will run Markdown on the current buffer and preview
;;     the output in another buffer while `C-c C-c p` runs Markdown on
;;     the current buffer and previews the output in a browser.
;;     `C-c C-c e` will run Markdown on the current buffer and save
;;     the result in the file `basename.html`, where `basename` is the
;;     name of the Markdown file with the extension removed.  **This
;;     file will be overwritten without notice.**  Press `C-c C-c v`
;;     to view the exported file in a browser.
;;
;;     `C-c C-c c` will check for undefined references.  If there are
;;     any, a small buffer will open with a list of undefined
