diff --git a/ChangeLog.md b/ChangeLog.md
new file mode 100644
--- /dev/null
+++ b/ChangeLog.md
@@ -0,0 +1,41 @@
+# Changelog for markdown
+
+## 0.1.17.2
+
+* Make test suite slightly more resilient to escaping rules
+
+## 0.1.17.1
+
+* Remove `OPTIONS_HADDOCK hide`
+
+## 0.1.17
+
+* Support GHC 8.4.1
+
+## 0.1.16
+
+* Add `setNoFollowExternal`
+
+## 0.1.15
+
+* defaultMarkdownSettings
+
+## 0.1.14
+
+* Handle named entities [#30](https://github.com/snoyberg/markdown/issues/30)
+
+## 0.1.13.2
+
+* Drop system-filepath
+
+## 0.1.13.1
+
+Fixes for GHC 7.10
+
+## 0.1.13
+
+Add `msAddHeadingId`.
+
+## 0.1.12
+
+Support for two spaces at end of line to create a linebreak.
diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+## Markdown for haskell
+
+**NOTE** This package is deprecated and no longer supported. Instead, please
+consider using [cmark] or [cmark-gfm].
+
+This is a haskell library for converting markdown to HTML. It's written in
+pure haskell. Also read the more technical description on [stackage].
+
+### Use with yesod
+
+For use with yesod, check out [yesod-text-markdown][ytm].
+
+[cmark]: https://www.stackage.org/package/cmark
+[cmark-gfm]: https://www.stackage.org/package/cmark-gfm
+[stackage]: https://www.stackage.org/package/markdown
+[ytm]: https://github.com/Tarrasch/yesod-text-markdown
diff --git a/markdown.cabal b/markdown.cabal
--- a/markdown.cabal
+++ b/markdown.cabal
@@ -1,5 +1,5 @@
 Name:                markdown
-Version:             0.1.17.1
+Version:             0.1.17.2
 Synopsis:            Convert Markdown to HTML, with XSS protection
 Description:         This library leverages existing high-performance libraries (attoparsec, blaze-html, text, and conduit), and should integrate well with existing codebases.
 Homepage:            https://github.com/snoyberg/markdown
@@ -13,6 +13,8 @@
                    , test/examples/*.md
                    , test/Tests/*.html
                    , test/Tests/*.text
+                   , ChangeLog.md
+                   , README.md
 Cabal-version:       >=1.8
 
 Library
diff --git a/test/main.hs b/test/main.hs
--- a/test/main.hs
+++ b/test/main.hs
@@ -225,7 +225,7 @@
         it "inline" $ check "<p>foo<br>bar</p>" "foo<br>bar"
         it "inline xss" $ check "<p>foo<br>bar</p>" "foo<br onclick='evil'>bar"
         it "block" $ check "<div>hello world</div>" "<div>hello world</div>"
-        it "block xss" $ check "alert('evil')" "<script>alert('evil')</script>"
+        it "block xss" $ check "alert(\"evil\")" "<script>alert(&quot;evil&quot;)</script>"
         it "should be escaped" $ check "<p>1 &lt; 2</p>" "1 < 2"
         it "standalone" $ checkSet
             def { msStandaloneHtml = Set.fromList ["<hidden>", "</hidden>"], msXssProtect = False }