template names and directory links

1 files changed, 6 insertions, 5 deletions

diff --git a/README.md b/README.md
index 910d6f5..f3ef773 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,12 @@ All non-underscore `.tmpl` files are loaded into one named template set. Files
 ending in `.html.tmpl` or `.xml.tmpl` also render to the same path without the
 `.tmpl` suffix. Other `.tmpl` files only define reusable templates.
 
-Markdown pages execute one of these required definitions:
-
-- `page` for ordinary paths
-- `weblog` below `weblog/`
-- `note` below `notes/`
+Markdown pages select the first defined template matching their source path,
+walking toward the site root before using the fallback. For example,
+`notes/recipes/cocktails/old_fashioned.md` checks
+`notes/recipes/cocktails/old_fashioned`, `notes/recipes/cocktails`,
+`notes/recipes`, `notes`, then `page`. Set a different fallback with
+`-fallback template`; it defaults to `page`.
 
 Template data exposes the current page fields (`.Title`, `.Meta`, `.Sections`,
 `.OutputPath`, and so on) plus `.Pages`, a map containing each Markdown page at