Add markdown deprecation notice to convertToMarkdown docs

1 files changed, 4 insertions, 0 deletions

diff --git a/README.md b/README.md
index 7772ff1..ad7ad69 100644
--- a/README.md
+++ b/README.md
@@ -381,6 +381,10 @@ Converts the source document to HTML.
 
 #### `mammoth.convertToMarkdown(input, options)`
 
+Markdown support is deprecated.
+Generating HTML and using a separate library to convert the HTML to Markdown is recommended,
+and is likely to produce better results.
+
 Converts the source document to Markdown.
 This behaves the same as `convertToHtml`,
 except that the `value` property of the result contains Markdown rather than HTML.