@@ -2688,6 +2688,12 @@ files, but you can use `.bibtex` to force BibTeX.
26882688Note that `pandoc-citeproc --bib2json` and `pandoc-citeproc --bib2yaml`
26892689can produce `.json` and `.yaml` files from any of the supported formats.
26902690
2691+In-field markup: In bibtex and biblatex databases, pandoc-citeproc parses
2692+(a subset of) LaTeX markup; in CSL JSON databases, an HTML-like markup
2693+([specs](http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields));
2694+and in CSL YAML databases, pandoc markdown. `pandoc-citeproc -j` and `-y`
2695+interconvert these markup formats as far as possible.
2696+
26912697As an alternative to specifying a bibliography file, you can include
26922698the citation data directly in the `references` field of the
26932699document's YAML metadata. The field should contain an array of