### Bug description

<https://quarto.org/docs/reference/metadata/citation.html> displays this example:

```
---
citation:
  type: article-journal
  container-title: ACM Transactions on Embedded Computing Systems
  volume: 21
  issue: 2
  date: 3/2022
  issn: 1539-9087
  doi: 10.1145/3514174
---
```

Issues:

- `date` is not a valid CSL variable; use `issued` instead.
- `3/2022` is not a valid CSL YAML date format; only ISO-8601 dates are accepted, e.g., `2022`, `2022-03`, `2022-03-29` etc.
- Hence `date: 3/2022` above should be replaced by `issued: 2022-03`.

Further suggestions:

- In quarto output, citation metadata are introduced as `BibTeX citation:` -- which, strictly speaking is not true: Neither `url`, nor `doi`, `langid` exist in BibTeX -- while the BibTeX variant natbib has `url` and `doi`, many others that appear in quarto output, including `langid`, `eventdate`, `urldate`, `annote` are exclusive to BibLaTeX.
- It might be useful to offer output in CSL YAML format instead or alongside BibLaTeX.
    - Possibly CSL JSON, too, which would allow lossless import into, e.g., Zotero. (CSL YAML import requires the BetterBibTeX plugin.)
- Empty BibLaTeX fields like `editor = {},` should be filtered out to reduce clutter.
- Markdown syntax in, e.g., `title` fields should be converted to the corresponding (La)TeX commands.
    - E.g., `title: Foo **bar**` should be converted to `title = {Foo \textbf{bar}},
    - Hence it might be easiest to use pandoc itself for converting `citation:` data from CSL to BibLaTeX, see <https://pandoc.org/MANUAL.html#specifying-bibliographic-data>.


### Checklist

- [ ] Please include a minimal, fully reproducible example in a single .qmd file? Please provide the whole file rather than the snippet you believe is causing the issue.
- [ ] Please [format your issue](https://quarto.org/bug-reports.html#formatting-make-githubs-markdown-work-for-us) so it is easier for us to read the bug report.
- [ ] Please document the RStudio IDE version you're running (if applicable), by providing the value displayed in the "About RStudio" main menu dialog?
- [ ] Please document the operating system you're running. If on Linux, please provide the specific distribution.
dragonstyle
2022-10-04T11:15:30Z
njbart
bug
v1.3
closed
Citation metadata: documentation issue
https://github.com/quarto-dev/quarto-cli/issues/2723