diff --git a/modella.md b/modella.md
index 44ab5a2f4..43f2bb845 100644
--- a/modella.md
+++ b/modella.md
@@ -52,6 +52,9 @@ user
 
 ```coffeescript
 Model.emit('event', [data...])
+```
+
+```coffeescript
 record.emit('event', [data...])
 ```
 
@@ -100,18 +103,16 @@ user
 ```coffeescript
 MyPlugin = ->
   return (Model) ->
-```
 
-```coffeescript
     Model.method = ...
     Model.prototype.method = ...
     Model.attr(...)
-```
 
-```coffeescript
     Model
 ```
 
+A plugin is a function that returns a model decorator (ie, a function that takes in a model and returns a model).
+
 ### Memory
 
 ```coffeescript