YAML header "tags:" does nothing but it's in documentation

[bulrush15]

Pandoc 2.2.1 on Windows 7.
Making an EPUB from a Markdown file.

In the Pandoc user guide there shows a YAML field called "tags:" but it doesn't seem to do anything. I cannot find the contents of "tags:" in the content.opf in the EPUB file. My markdown file test1.md:

---
title: My title
author: John Author
date: 2017-03
subject: plague, Manchuria
description: A description of the book from the "description:" YAML field.
tags: [tag1, tag2]
---

# Introduction

Updated: 2018-0421

My pandoc command line: pandoc --from=markdown+backtick_code_blocks+pipe_tables --to=epub --css=style01.css --output=test1.epub test1.md

Documentation screen shot that shows "tags:":

[jgm]

The purpose of that part of the documentation is to show how a YAML block can be used to set fields in the document's metadata. And, the tags list is being added to the document's metadata. (To see this, do pandoc -t native -s.) You can use any field names you like; tags was just an example here.

It's just that the writer and template you're using don't do anything with the tags field in the metadata, so you see nothing in the epub file produced.

Perhaps we should replace this with keywords in the example, since keywords is actually used in some of the writers. Not in EPUB though. Is there a standard way to encode keywords in a content.opf?

[jgm]

Closing this with the docs change. Feel free to open a new issue requesting that keywords in metadata do something to the content.opf in an EPUB. (Give details about what it should do.)

[vv01f]

@jgm in case you're still up to add that … keywords go each separate into dc:subject nodes in the file content.opf, calibre shows those comma-separated as "tags" in metadata dialogue.

[jgm]

@vv01f please open a new issue describing what should be done