Implement package/resource/schema.to_markdown

Overview

https://framework.frictionlessdata.io/docs/guides/describing-data

In Frictionless Framework a user can instantiate a Schema, Resource, and Package objects. All of them are Metadata objects which is a Python dictionary with some additional functionality.

For example, all these classes have metadata.to_yaml that converts the metadata that a package/resource/schema has to a YAML string or file.

Users are interested in having package/resource/schema.to_markdown function that will convert metadata to a MD string or file. It might be useful for composing readmes on github etc. See https://github.com/frictionlessdata/project/discussions/665

Plan

• Review an existing external lib for reference (not sure we can re-use this code)
• Decide on the way of composing markdown text: using some markdown composer, Jinja template or native Python strings (the latter might be messy) ping @roll to sync
• Decide on what should be a Markdown output. For example, this one for a Table Schema - https://github.com/geoffreyaldebert/table-schema-to-markdown/blob/master/tests/files/expected_repertoire.md. And this one - https://datahub.io/core/co2-ppm - is a package presentation (of course we can’t have interactive parts) ping @roll to sync
• Prototype all the functions
• Implement all the functions adding docstrings
• Write functional tests

[roll]

Thanks for the suggestion – I’ve added a feature request for it

[roll]

And of course, thanks to @ezwelty 👍