 (deftask markdown
   "Parse markdown files
 
-   This task will look for files ending with `md` or `markdown`
-   and add a `:parsed` key to their metadata containing the
-   HTML resulting from processing markdown file's content"
+  This task will look for files ending with `md` or `markdown`
+  and add a `:parsed` key to their metadata containing the
+  HTML resulting from processing markdown file's content. It
+  will parse YAML metadata at the head of the file, and add
+  any data found to the output's metadata."
   [d out-dir  OUTDIR  str "the output directory"
    m meta     META    edn "metadata to set on each entry; keys here will be overridden by metadata in each file"
    o options  OPTS    edn "options to be passed to the markdown parser"]

   :extensions []})

(deftask yaml-metadata
  [e extensions EXTENSIONS [str] "extensions of files to include (default: `[]`, aka, all extensions)"]
  (let [pod     (create-pod yaml-metadata-deps)
        options (merge +yaml-metadata-defaults+ *opts*)]

(deftask markdown*
  "Parse markdown files

  This task will look for files ending with `md` or `markdown`
  and add a `:parsed` key to their metadata containing the
  HTML resulting from processing markdown file's content. It
  will not parse YAML metadata at the head of the file."
  [d out-dir  OUTDIR  str "the output directory"
   m meta     META    edn "metadata to set on each entry; keys here will be overridden by metadata in each file"
   o options  OPTS    edn "options to be passed to the markdown parser"]
