docs: changelog and docs for coverage report --format=markdown

Author: nedbat

CHANGES.rst

@@ -20,9 +20,16 @@ development at the same time, such as 4.5.x and 5.0.
 Unreleased
 ----------
 
+- Text reporting with ``coverage report`` now has a ``--format=`` option.
+  The original style (``--format=text``) is the default.  Now you can also
+  use ``--format=markdown`` to get the table in Markdown format, thanks to
+  Steve Oswald in `pull 1479`_, closing `issue 1418`_.
+
 - Fixed a mis-measurement of a strange use of wildcard alternatives in
   match/case statements, closing `issue 1421`_.
 
+.. _pull 1479: https://github.com/nedbat/coveragepy/pull/1479
+.. _issue 1418: https://github.com/nedbat/coveragepy/issues/1418
 .. _issue 1421: https://github.com/nedbat/coveragepy/issues/1421
 
 

CONTRIBUTORS.txt

@@ -150,6 +150,7 @@ Stephan Richter
 Stephen Finucane
 Steve Dower
 Steve Leonard
+Steve Oswald
 Steve Peak
 Sviatoslav Sydorenko
 S. Y. Lee

doc/cmd.rst

@@ -592,6 +592,10 @@ decimal point in coverage percentages, defaulting to none.
 
 The ``--sort`` option is the name of a column to sort the report by.
 
+The ``--format`` option controls the style of the table.  ``--format=text``
+creates plain text tables as shown above.  ``--format=markdown`` creates
+Markdown tables.
+
 Other common reporting options are described above in :ref:`cmd_reporting`.
 These options can also be set in your .coveragerc file. See
 :ref:`Configuration: [report] <config_report>`.