         required? (if (string/includes? (:full-name m) "/")
                     (:required? markdown-keys)
                     (:ns-required? markdown-keys))]
-    (when (or value (required? key))
+    (when (or (not (blank? value))
+              (required? key))
       (cond
         (blank? value)   (str section-start title "\n")
         (list? key)      (str section-start title "\n" (string/join "\n" value) "\n")

  [[key title] m]
  (let [value (get m key)
        list? (:list? frontmatter-keys)
        required? (if (string/starts-with? (:full-name m) "syntax/")
                    (:syntax-required? frontmatter-keys)
                    (:required? frontmatter-keys))]
    (when (or value (required? key))
      (cond
        (blank? value)   (str title)
        (list? key)      (str title "\n" (yaml-list value))

         [:see-also "see also:"]]
   :required?        #{:full-name :see-also}
   :syntax-required? #{:full-name :see-also :display}
   :ns-required?     #{:full-name}
   :list?            #{:tags :see-also}})

(def markdown-keys
