docs($filter): improve description formatting

Author: gkalpak

src/ng/filter.js

@@ -73,13 +73,17 @@
  * @name $filter
  * @kind function
  * @description
- * Filters are used for formatting data displayed to the user. They can be used in view
- * templates, controllers or services. Angular comes with a collection of
- * [built-in filters](api/ng/filter), but it is easy to define your own as well.
+ * Filters are used for formatting data displayed to the user.
+ *
+ * They can be used in view templates, controllers or services.Angular comes
+ * with a collection of [built-in filters](api/ng/filter), but it is easy to
+ * define your own as well.
  *
  * The general syntax in templates is as follows:
  *
- *         {{ expression [| filter_name[:parameter_value] ... ] }}
+ * ```html
+ * {{ expression [| filter_name[:parameter_value] ... ] }}
+ * ```
  *
  * @param {String} name Name of the filter function to retrieve
  * @return {Function} the filter function