diff --git a/.remarkrc-man b/.remarkrc-man
index d8672e513..b82b28e92 100644
--- a/.remarkrc-man
+++ b/.remarkrc-man
@@ -4,7 +4,7 @@
     "remark-man": {
       "date": "2015-12-01",
       "manual": "remark manual",
-      "version": "2.3.2"
+      "version": "3.0.0"
     }
   }
 }
diff --git a/component.json b/component.json
index f7926c1f9..0d57b5a9c 100644
--- a/component.json
+++ b/component.json
@@ -1,6 +1,6 @@
 {
   "name": "remark",
-  "version": "2.3.2",
+  "version": "3.0.0",
   "description": "Markdown processor powered by plugins",
   "license": "MIT",
   "keywords": [
diff --git a/history.md b/history.md
index f6cc9d628..02d5b1e02 100644
--- a/history.md
+++ b/history.md
@@ -2,6 +2,24 @@
 
 <!--lint disable no-multiple-toplevel-headings maximum-line-length-->
 
+3.0.0 / 2015-12-25
+==================
+
+*   Add migration guide and temporary warnings ([269f521](https://github.com/wooorm/remark/commit/269f521))
+*   Update list of plugins with project renames ([fb0fea9](https://github.com/wooorm/remark/commit/fb0fea9))
+*   Rename `mdast` to `remark` ([38fe53d](https://github.com/wooorm/remark/commit/38fe53d))
+*   Fix bug where blockquotes had trailing spaces ([a51f112](https://github.com/wooorm/remark/commit/a51f112))
+*   Refactor support for entities ([0c7b649](https://github.com/wooorm/remark/commit/0c7b649))
+*   Refactor code-style ([3dc2485](https://github.com/wooorm/remark/commit/3dc2485))
+*   Add documentation for interfacing with the parser ([7a5d16d](https://github.com/wooorm/remark/commit/7a5d16d))
+*   Fix footnote definitions without spacing ([46714b2](https://github.com/wooorm/remark/commit/46714b2))
+*   Fix empty `alt` value for `imageReference`, `image` ([698d569](https://github.com/wooorm/remark/commit/698d569))
+*   Fix unclosed angle-bracketed definition ([acebf81](https://github.com/wooorm/remark/commit/acebf81))
+*   Add escaping to compiler ([d1fe019](https://github.com/wooorm/remark/commit/d1fe019))
+*   Fix handling of definitions in commonmark-mode ([b7d6e53](https://github.com/wooorm/remark/commit/b7d6e53))
+*   Fix handling of list-item bullets in gfm-mode ([6e74759](https://github.com/wooorm/remark/commit/6e74759))
+*   Refactor to remove regular expressions ([25a26f2](https://github.com/wooorm/remark/commit/25a26f2))
+
 2.3.2 / 2015-12-21
 ==================
 
diff --git a/index.js b/index.js
index e8f8fbdef..57c9510af 100644
--- a/index.js
+++ b/index.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Markdown processor powered by plugins.
  */
 
diff --git a/lib/cli/cli.js b/lib/cli/cli.js
index 4b407a1ff..fc69c1851 100644
--- a/lib/cli/cli.js
+++ b/lib/cli/cli.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:cli
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Bridge between CLI options and node.
  */
 
diff --git a/lib/cli/configuration.js b/lib/cli/configuration.js
index 0349b4bb0..375eb6ca0 100644
--- a/lib/cli/configuration.js
+++ b/lib/cli/configuration.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:configuration
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Find remark rc files.
  */
 
diff --git a/lib/cli/file-pipeline/configure.js b/lib/cli/file-pipeline/configure.js
index 5875eff56..d8f340815 100644
--- a/lib/cli/file-pipeline/configure.js
+++ b/lib/cli/file-pipeline/configure.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:configure
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Configure a file.
  */
 
diff --git a/lib/cli/file-pipeline/copy.js b/lib/cli/file-pipeline/copy.js
index 026c76155..f34262c48 100644
--- a/lib/cli/file-pipeline/copy.js
+++ b/lib/cli/file-pipeline/copy.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:copy
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Move a file.
  */
 
diff --git a/lib/cli/file-pipeline/file-system.js b/lib/cli/file-pipeline/file-system.js
index 118b44f47..4cecb4eec 100644
--- a/lib/cli/file-pipeline/file-system.js
+++ b/lib/cli/file-pipeline/file-system.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:file-system
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Write a file to the file system.
  */
 
diff --git a/lib/cli/file-pipeline/index.js b/lib/cli/file-pipeline/index.js
index 0019031ec..639269afc 100644
--- a/lib/cli/file-pipeline/index.js
+++ b/lib/cli/file-pipeline/index.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Process a file.
  */
 
diff --git a/lib/cli/file-pipeline/parse.js b/lib/cli/file-pipeline/parse.js
index d91e89bff..9fed1bc47 100644
--- a/lib/cli/file-pipeline/parse.js
+++ b/lib/cli/file-pipeline/parse.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:parse
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Parse a file into an AST.
  */
 
diff --git a/lib/cli/file-pipeline/queue.js b/lib/cli/file-pipeline/queue.js
index f7694ebb0..df2191df6 100644
--- a/lib/cli/file-pipeline/queue.js
+++ b/lib/cli/file-pipeline/queue.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:queue
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Queue all files which came this far.
  */
 
diff --git a/lib/cli/file-pipeline/read.js b/lib/cli/file-pipeline/read.js
index b83f31a1a..fe12d2a1c 100644
--- a/lib/cli/file-pipeline/read.js
+++ b/lib/cli/file-pipeline/read.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:read
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Read a file if not already filled.
  */
 
diff --git a/lib/cli/file-pipeline/stdout.js b/lib/cli/file-pipeline/stdout.js
index b95591bf4..6349fc9cb 100644
--- a/lib/cli/file-pipeline/stdout.js
+++ b/lib/cli/file-pipeline/stdout.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:stdout
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Write a file to stdout(4).
  */
 
diff --git a/lib/cli/file-pipeline/stringify.js b/lib/cli/file-pipeline/stringify.js
index 585b66e91..1ef9ee36a 100644
--- a/lib/cli/file-pipeline/stringify.js
+++ b/lib/cli/file-pipeline/stringify.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:stringify
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Compile an AST into a file.
  */
 
diff --git a/lib/cli/file-pipeline/transform.js b/lib/cli/file-pipeline/transform.js
index ebc404512..7df0aaeae 100644
--- a/lib/cli/file-pipeline/transform.js
+++ b/lib/cli/file-pipeline/transform.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-pipeline:transform
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Transform an AST associated with a file.
  */
 
diff --git a/lib/cli/file-set-pipeline/configure.js b/lib/cli/file-set-pipeline/configure.js
index e60bfb08d..8f7f2ee3e 100644
--- a/lib/cli/file-set-pipeline/configure.js
+++ b/lib/cli/file-set-pipeline/configure.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set-pipeline:configure
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Configure a collection of files.
  */
 
diff --git a/lib/cli/file-set-pipeline/file-system.js b/lib/cli/file-set-pipeline/file-system.js
index f961c8b0f..9f15ec68e 100644
--- a/lib/cli/file-set-pipeline/file-system.js
+++ b/lib/cli/file-set-pipeline/file-system.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set-pipeline:traverse
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Find files from the file-system.
  */
 
diff --git a/lib/cli/file-set-pipeline/index.js b/lib/cli/file-set-pipeline/index.js
index 79bb2afae..09a175c4c 100644
--- a/lib/cli/file-set-pipeline/index.js
+++ b/lib/cli/file-set-pipeline/index.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set-pipeline
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Process a collection of files.
  */
 
diff --git a/lib/cli/file-set-pipeline/log.js b/lib/cli/file-set-pipeline/log.js
index d1ac2f711..de2d2d3eb 100644
--- a/lib/cli/file-set-pipeline/log.js
+++ b/lib/cli/file-set-pipeline/log.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:log
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Log a file context on successful completion.
  */
 
diff --git a/lib/cli/file-set-pipeline/stdin.js b/lib/cli/file-set-pipeline/stdin.js
index 7f2c4785d..51c3e88ca 100644
--- a/lib/cli/file-set-pipeline/stdin.js
+++ b/lib/cli/file-set-pipeline/stdin.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set-pipeline:stdin
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Read from stdin.
  */
 
diff --git a/lib/cli/file-set-pipeline/transform.js b/lib/cli/file-set-pipeline/transform.js
index 4b1fdc317..e1ad98ef8 100644
--- a/lib/cli/file-set-pipeline/transform.js
+++ b/lib/cli/file-set-pipeline/transform.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set-pipeline:transform
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Transform all files.
  */
 
diff --git a/lib/cli/file-set.js b/lib/cli/file-set.js
index 7b7ca1922..e964974ca 100644
--- a/lib/cli/file-set.js
+++ b/lib/cli/file-set.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:file-set
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Collection of virtual files.
  */
 
diff --git a/lib/cli/finder.js b/lib/cli/finder.js
index e8c4daf6b..a313cf2a0 100644
--- a/lib/cli/finder.js
+++ b/lib/cli/finder.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:traverser
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Get applicable input files from
  *   the file system to be processed by remark, respecting
  *   ignored paths and applicable extensions.
diff --git a/lib/cli/ignore.js b/lib/cli/ignore.js
index 10d1f0218..98751eea7 100644
--- a/lib/cli/ignore.js
+++ b/lib/cli/ignore.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:ignore
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Find remark ignore files.
  */
 
diff --git a/lib/cli/index.js b/lib/cli/index.js
index 5dfa3fc49..6150a09f8 100644
--- a/lib/cli/index.js
+++ b/lib/cli/index.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview CLI Engine.
  */
 
diff --git a/lib/cli/spinner.js b/lib/cli/spinner.js
index fc0eacba0..9dccae11e 100644
--- a/lib/cli/spinner.js
+++ b/lib/cli/spinner.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:cli:spinner
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview A spinner for stdout(4).
  */
 
diff --git a/lib/cli/watch-output-cache.js b/lib/cli/watch-output-cache.js
index 0a4e8ce0a..5a10cedb2 100644
--- a/lib/cli/watch-output-cache.js
+++ b/lib/cli/watch-output-cache.js
@@ -2,7 +2,7 @@
  * @author YJ Yang
  * @copyright 2015 Titus Wormer
  * @license MIT
- * @version 2.3.2
+ * @version 3.0.0
  * @module remark:cli:watch-output-cache
  * @fileoverview Cache changed files which are also watched.
  */
diff --git a/lib/defaults.js b/lib/defaults.js
index 60d184227..d9f5976a8 100644
--- a/lib/defaults.js
+++ b/lib/defaults.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:defaults
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Default values for parse and
  *  stringification settings.
  */
diff --git a/lib/parse.js b/lib/parse.js
index d2724ae10..2a521319a 100644
--- a/lib/parse.js
+++ b/lib/parse.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:parse
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Parse a markdown document into an
  *   abstract syntax tree.
  */
diff --git a/lib/stringify.js b/lib/stringify.js
index 1cf81703f..7b10b3a75 100644
--- a/lib/stringify.js
+++ b/lib/stringify.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:stringify
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Compile an abstract syntax tree into
  *   a markdown document.
  */
diff --git a/lib/utilities.js b/lib/utilities.js
index 587bbd2f6..fc810b96b 100644
--- a/lib/utilities.js
+++ b/lib/utilities.js
@@ -3,7 +3,7 @@
  * @copyright 2015 Titus Wormer
  * @license MIT
  * @module remark:utilities
- * @version 2.3.2
+ * @version 3.0.0
  * @fileoverview Collection of tiny helpers useful for
  *   both parsing and compiling markdown.
  */
diff --git a/man/remark.1 b/man/remark.1
index 176e4f5ae..214c31f52 100644
--- a/man/remark.1
+++ b/man/remark.1
@@ -1,4 +1,4 @@
-.TH "REMARK" "1" "December 2015" "2.3.2" "remark manual"
+.TH "REMARK" "1" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremark\fR - Markdown processor
 .SH "SYNOPSIS"
diff --git a/man/remark.3 b/man/remark.3
index 172187feb..1b559feb4 100644
--- a/man/remark.3
+++ b/man/remark.3
@@ -1,4 +1,4 @@
-.TH "REMARK" "3" "December 2015" "2.3.2" "remark manual"
+.TH "REMARK" "3" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremark\fR - Markdown processor
 .SH "SYNOPSIS"
diff --git a/man/remarkconfig.7 b/man/remarkconfig.7
index 8e4d22046..bbeeba138 100644
--- a/man/remarkconfig.7
+++ b/man/remarkconfig.7
@@ -1,4 +1,4 @@
-.TH "REMARKCONFIG" "7" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKCONFIG" "7" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarkconfig\fR - remark configuration
 .SH "SYNOPSIS"
diff --git a/man/remarkignore.5 b/man/remarkignore.5
index ebe487b57..9e2e29a5c 100644
--- a/man/remarkignore.5
+++ b/man/remarkignore.5
@@ -1,4 +1,4 @@
-.TH "REMARKIGNORE" "5" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKIGNORE" "5" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarkignore\fR - remark ignore files
 .SH "SYNOPSIS"
diff --git a/man/remarkplugin.3 b/man/remarkplugin.3
index 4ea750787..56f8b921f 100644
--- a/man/remarkplugin.3
+++ b/man/remarkplugin.3
@@ -1,4 +1,4 @@
-.TH "REMARKPLUGIN" "3" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKPLUGIN" "3" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarkplugin\fR - remark plug-in creation
 .SH "SYNOPSIS"
diff --git a/man/remarkplugin.7 b/man/remarkplugin.7
index d9d6e4927..e530ce8b1 100644
--- a/man/remarkplugin.7
+++ b/man/remarkplugin.7
@@ -1,4 +1,4 @@
-.TH "REMARKPLUGIN" "7" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKPLUGIN" "7" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarkplugin\fR - remark plug-in usage
 .SH "SYNOPSIS"
diff --git a/man/remarkrc.5 b/man/remarkrc.5
index 090a7880d..c4616942c 100644
--- a/man/remarkrc.5
+++ b/man/remarkrc.5
@@ -1,4 +1,4 @@
-.TH "REMARKRC" "5" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKRC" "5" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarkrc\fR - remark config files
 .SH "SYNOPSIS"
diff --git a/man/remarksetting.7 b/man/remarksetting.7
index 0861a1460..721f97d69 100644
--- a/man/remarksetting.7
+++ b/man/remarksetting.7
@@ -1,4 +1,4 @@
-.TH "REMARKSETTING" "7" "December 2015" "2.3.2" "remark manual"
+.TH "REMARKSETTING" "7" "December 2015" "3.0.0" "remark manual"
 .SH "NAME"
 \fBremarksetting\fR - remark settings
 .SH "SYNOPSIS"
diff --git a/package.json b/package.json
index 0004cb595..fbbac7562 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "remark",
-  "version": "2.3.2",
+  "version": "3.0.0",
   "description": "Markdown processor powered by plugins",
   "license": "MIT",
   "keywords": [