diff --git a/v3-docs/docs/packages/markdown.md b/v3-docs/docs/packages/markdown.md
new file mode 100644
index 0000000000..b01874d3f7
--- /dev/null
+++ b/v3-docs/docs/packages/markdown.md
@@ -0,0 +1,39 @@
+# Markdown
+
+> Note: This package has been deprecated.
+
+This package lets you use Markdown in your templates.
+
+### Installation
+
+```sh
+meteor add markdown
+```
+
+### Usage
+
+This package is lazy loaded. Is is not added into the initial Bundle.
+So you need to import it in your template.
+
+```js
+// myTemplate.js
+import 'meteor/markdown';
+```
+
+Then just put your markdown inside `{{#markdown}} ... {{/markdown}}`
+tags. You can still use all of the usual Meteor template features
+inside a Markdown block, such as `{{#each}}`, and you still get
+reactivity.
+
+Example:
+
+```html
+<!-- myTemplate.html -->
+{{#markdown}}I am using __markdown__.{{/markdown}}
+```
+
+outputs
+
+```html
+<p>I am using <strong>markdown</strong>.</p>
+```