1diff --git a/plugins/perl/README.md b/plugins/perl/README.md
2index f2f4b79ec27489339d229b4f82370b797899606f..dd9b7dc75392d155674f5dd669f9db40d0b09a9d 100644
3--- a/plugins/perl/README.md
4+++ b/plugins/perl/README.md
5@@ -10,27 +10,28 @@ plugins=(... perl)
6 7 ## Aliases
8 9-| Aliases | Command | Description |
10-| :------------ | :-------------- | :----------------------------------- |
11-| pbi | perlbrew install|Install specific perl version |
12-| pbl | perlbrew list |List all perl version installed |
13-| pbo | perlbrew off |Go back to the system perl |
14-| pbs | perlbrew switch |Turn it back on |
15-| pbu | perlbrew use |Use specific version of perl |
16-| pd | perldoc |Show the perl documentation |
17-| ple | perl -wlne |Use perl like awk/sed |
18-| latest-perl | curl `...` |Show the latest stable release of Perl|
19+| Aliases | Command | Description |
20+| :------------ | :----------------- | :------------------------------------- |
21+| pbi | `perlbrew install` | Install specific perl version |
22+| pbl | `perlbrew list` | List all perl version installed |
23+| pbo | `perlbrew off` | Go back to the system perl |
24+| pbs | `perlbrew switch` | Turn it back on |
25+| pbu | `perlbrew use` | Use specific version of perl |
26+| pd | `perldoc` | Show the perl documentation |
27+| ple | `perl -wlne` | Use perl like awk/sed |
28+| latest-perl | `curl ...` | Show the latest stable release of Perl |
2930 ## Functions
3132-`newpl` - creates a basic Perl script file and opens it with $EDITOR
33+* `newpl`: creates a basic Perl script file and opens it with $EDITOR.
3435-`pgs` - Perl Global Substitution (find pattern = 1st arg ; replace pattern = 2nd arg ; filename = 3rd arg)
36+* `pgs`: Perl Global Substitution: `pgs <find_pattern> <replace_pattern> <filename>`
37+ Looks for `<find_pattern>` and replaces it with `<replace_pattern>` in `<filename>`.
3839-`prep` - Perl grep, because 'grep -P' is terrible. Lets you work with pipes or files. (pattern = 1st arg ; filename = 2nd arg)
40+* `prep`: Perl grep, because 'grep -P' is terrible: `prep <pattern> [<filename>]`
41+ Lets you work with pipes or files (if no `<filename>` provided, use stdin).
4243 ## Requirements
4445 In order to make this work, you will need to have perl installed.
46-
47 More info on the usage and install: https://www.perl.org/get.html