diff --git a/README.asciidoc b/README.asciidoc
index 817f6a23..ae9526fb 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -76,3 +76,19 @@ Changes
  * _p_: paste after current selection end
  * _P_: paste before current selection begin
 
+Filters
+-------
+
+Manipulation of the displayed text is done through filters, which can be added or
+removed with the command :addfilter <filter_name> <filter_parameters...>
+
+existing filters are:
+
+* *hlcpp*: takes no parameters, highlight c++ code
+* *line_numbers*: takes no parameters, display line numbers on the left of the window
+
+Windows also contains two filters by default, which are not currently addable
+(but they are removable)
+
+* *show_tabs*: which expand tabs to next 8 multiple column
+* *show_selection*: which underlines the current selections