general: Reformat documentation with better formatting and wording

General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://').
4 years ago · d80e393f78
parent 8edc5e9323
commit d80e393f78
44 changed files with 1245 additions and 1453 deletions
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -1,42 +1,41 @@
-Contributing
+# Contributing
 ------------
 This project would not exist without all of its users and [contributors][1].
 If you have ideas on how to make the configuration easier to maintain or
 improve its performance, do not hesitate to fork and send pull requests.
-### Issue Reporting
+## Issue Reporting
-   - Check that the issue has not already been reported.
+- Check that the issue has not already been reported.
-   - Check that the issue has not already been fixed in the latest code.
+- Check that the issue has not already been fixed in the latest code.
-   - Open an issue with a clear title and description in grammatically correct,
+- Open an issue with a clear title and description in grammatically correct,
-     complete sentences.
+  complete sentences.
-### Pull Request
+## Pull Request
-   - Read [how to properly contribute to open source projects on GitHub][2].
+- Read [how to properly contribute to open source projects on GitHub][2].
-   - Use a topic branch to easily amend a pull request later, if necessary.
+- Use a topic branch to easily amend a pull request later, if necessary.
-   - Write [good commit messages][3].
+- Write [good commit messages][3].
-   - Squash commits on the topic branch before opening a pull request.
+- Squash commits on the topic branch before opening a pull request.
-   - Use the same coding style and spacing.
+- Use the same coding style and spacing.
-   - Open a [pull request][4] that relates to but one subject with a clear
+- Open a [pull request][4] that relates to but one subject with a clear title
-     title and description in grammatically correct, complete sentences.
+  and description in grammatically correct, complete sentences.
-#### Code Style
+### Code Style
 This project follows the [Google Shell Style Guide][5] when possible. However,
 there are a number of additional things to keep in mind.
-   - Local variables should be used whenever possible.
+- Local variables should be used whenever possible.
-   - Prefer `zstyle` over environment variables for configuration.
+- Prefer `zstyle` over environment variables for configuration.
-   - Prefer (( ... )) over [[ ... ]] for arithmetic expression.
+- Prefer (( ... )) over [[ ... ]] for arithmetic expression.
-   - Use the function keyword to define functions.
+- Use the function keyword to define functions.
-   - The 80 character hard limit can be waived for readability.
+- The 80 character hard limit can be waived for readability.
-#### Using an Alternative zprezto Directory
+### Using an Alternative *zprezto* Directory
-To work on zprezto without messing with your current configuration:
+To work on Prezto without affecting your current configuration:
 ```sh
 mkdir devel-zprezto
@ -52,24 +51,24 @@ done
 Then to start zsh in this development environment you will run:
-```sh
+```console
 ZDOTDIR=/path/to/devel-zprezto zsh
 ```
-#### Modules
+### Modules
-   - A *README.md* must be present.
+- A *README.md* must be present.
-   - Large functions must be placed in a *functions* directory.
+- Large functions must be placed in a *functions* directory.
-   - Functions that take arguments must have completion.
+- Functions that take arguments must have completion.
-#### Themes
+### Themes
-   - A screenshots section must be present in the file header.
+- A screenshots section must be present in the file header.
-   - The pull request description must have [embedded screenshots][6].
+- The pull request description must have [embedded screenshots][6].
 [1]: https://github.com/sorin-ionescu/prezto/contributors
-[2]: http://gun.io/blog/how-to-github-fork-branch-and-pull-request
+[2]: https://gun.io/blog/how-to-github-fork-branch-and-pull-request
 [3]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
 [4]: https://help.github.com/articles/using-pull-requests
 [5]: https://google.github.io/styleguide/shell.xml
-[6]: http://daringfireball.net/projects/markdown/syntax#img
+[6]: https://github.github.com/gfm/#images
--- a/README.md
+++ b/README.md
@ -1,66 +1,64 @@
-Prezto — Instantly Awesome Zsh
+# Prezto — Instantly Awesome Zsh
 ==============================
 Prezto is the configuration framework for [Zsh][1]; it enriches the command line
 interface environment with sane defaults, aliases, functions, auto completion,
 and prompt themes.
-Installation
+## Installation
 ------------
 Prezto will work with any recent release of Zsh, but the minimum required
-version is 4.3.11.
+version is **4.3.11**.
-  1. Launch Zsh:
+01. Launch Zsh:
-     ```console
+    ```console
-     zsh
+    zsh
-     ```
+    ```
-  2. Clone the repository:
+02. Clone the repository:
-     ```console
+    ```console
-     git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
+    git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
-     ```
+    ```
-  3. Create a new Zsh configuration by copying the Zsh configuration files
+03. Create a new Zsh configuration by copying the Zsh configuration files
-     provided:
+    provided:
-     ```sh
+    ```console
-     setopt EXTENDED_GLOB
+    setopt EXTENDED_GLOB
-     for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
+    for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
-       ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
+      ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
-     done
+    done
-     ```
+    ```
-     Note: If you already have any of the given configuration files, `ln` will
+    **Note:** If you already have any of the given configuration files, `ln` in
-     cause error. In simple cases you can load prezto by adding the line
+    the above operation will cause an error. In simple cases, you can load
-     `source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh"` to the bottom of your
+    Prezto by adding the line `source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh"` to
-     `.zshrc` and keep the rest of your Zsh configuration intact. For more
+    the bottom of your *${ZDOTDIR:-$HOME}/.zshrc* and keep the rest of your Zsh
-     complicated setups, it is recommended that you back up your original
+    configuration intact. For more complicated setups, we recommend that you
-     configs and replace them with the provided prezto runcoms.
+    back up your original configs and replace them with the provided Prezto
    *runcoms*.
-  4. Set Zsh as your default shell:
+04. Set Zsh as your default shell:
-     ```console
+    ```console
-     chsh -s /bin/zsh
+    chsh -s /bin/zsh
-     ```
+    ```
-  5. Open a new Zsh terminal window or tab.
+05. Open a new Zsh terminal window or tab.
 ### Troubleshooting
-If you are not able to find certain commands after switching to *Prezto*,
+If you are not able to find certain commands after switching to Prezto, modify
-modify the `PATH` variable in *~/.zprofile* then open a new Zsh terminal
+the `PATH` variable in *${ZDOTDIR:-$HOME}/.zprofile* then open a new Zsh
-window or tab.
+terminal window or tab.
-Updating
+## Updating
 --------
-Run `zprezto-update` to automatically check if there is an update to zprezto.
+Run `zprezto-update` to automatically check if there is an update to Prezto.
-If there are no file conflicts, zprezto and its submodules will be
+If there are no file conflicts, Prezto and its submodules will be automatically
-automatically updated. If there are conflicts you will be instructed to go into
+updated. If there are conflicts you will be instructed to go into the
-the `$ZPREZTODIR` directory and resolve them yourself.
+`$ZPREZTODIR` directory and resolve them yourself.
 To pull the latest changes and update submodules manually:
@ -70,67 +68,63 @@ git pull
 git submodule update --init --recursive
 ```
-Usage
+## Usage
 -----
-Prezto has many features disabled by default. Read the source code and
+Prezto has many features disabled by default. Read the source code and the
-accompanying README files to learn of what is available.
+accompanying README files to learn about what is available.
 ### Modules
-  1. Browse */modules* to see what is available.
+01. Browse */modules* to see what is available.
-  2. Load the modules you need in *~/.zpreztorc* then open a new Zsh terminal
+02. Load the modules you need in *${ZDOTDIR:-$HOME}/.zpreztorc* then open a new
-     window or tab.
+    Zsh terminal window or tab.
 ### Themes
-  1. For a list of themes, type `prompt -l`.
+01. For a list of themes, type `prompt -l`.
-  2. To preview a theme, type `prompt -p name`.
+02. To preview a theme, type `prompt -p name`.
-  3. Load the theme you like in *~/.zpreztorc* then open a new Zsh terminal
+03. Load the theme you like in *${ZDOTDIR:-$HOME}/.zpreztorc* then open a new
-     window or tab.
+    Zsh terminal window or tab.
-     ![sorin theme][2]
+    ![sorin theme][2]
-     Note that the 'git' module may be required for special symbols to appear,
+    Note that the *git* module may be required for special symbols to appear,
-     such as those on the right of the above image. Add `'git'` to the `pmodule`
+    such as those on the right of the above image. Add `'git'` to the `pmodule`
-     list (under `zstyle ':prezto:load' pmodule \` in your *~/.zpreztorc*) to
+    list (under `zstyle ':prezto:load' pmodule \` in your
-     enable this module.
+    *${ZDOTDIR:-$HOME}/.zpreztorc*) to enable this module.
 ### External Modules
-  1. By default modules will be loaded from */modules* and */contrib*.
+01. By default modules will be loaded from */modules* and */contrib*.
-  2. Additional module directories can be added to the
+02. Additional module directories can be added to the
-     `:prezto:load:pmodule-dirs` setting in *~/.zpreztorc*.
+    `:prezto:load:pmodule-dirs` setting in *${ZDOTDIR:-$HOME}/.zpreztorc*.
-     Note that module names need to be unique or they will cause an error when
+    Note that module names need to be unique or they will cause an error when
-     loading.
+    loading.
-     ```sh
+    ```console
-     zstyle ':prezto:load' pmodule-dirs $HOME/.zprezto-contrib
+    zstyle ':prezto:load' pmodule-dirs $HOME/.zprezto-contrib
-     ```
+    ```
-Customization
+## Customization
 -------------
-The project is managed via [Git][3]. It is highly recommended that you fork this
+The project is managed via [Git][3]. We highly recommend that you fork this
-project; so, that you can commit your changes and push them to [GitHub][4] to
+project so that you can commit your changes and push them to your fork on
-not lose them. If you do not know how to use Git, follow this [tutorial][5] and
+[GitHub][4] to preserve them. If you do not know how to use Git, follow this
-bookmark this [reference][6].
+[tutorial][5] and bookmark this [reference][6].
-Resources
+## Resources
 ---------
 The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
-License
+## License
 -------
 This project is licensed under the MIT License.
-[1]: http://www.zsh.org
+[1]: https://www.zsh.org
-[2]: http://i.imgur.com/nrGV6pg.png "sorin theme"
+[2]: https://i.imgur.com/nrGV6pg.png "sorin theme"
-[3]: http://git-scm.com
+[3]: https://git-scm.com
 [4]: https://github.com
-[5]: http://gitimmersion.com
+[5]: https://gitimmersion.com
 [6]: https://git.github.io/git-reference/
 [7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
-[8]: http://grml.org/zsh/zsh-lovers.html
+[8]: https://grml.org/zsh/zsh-lovers.html
--- a/modules/README.md
+++ b/modules/README.md
@ -1,206 +1,166 @@
-Modules
+# Modules
 =======
-Load modules in *zpreztorc*. The order matters.
+Load modules in *~/.zpreztorc*. The order matters.
 ```sh
 zstyle ':prezto:load' pmodule 'environment' 'terminal'
 ```
-Archive
+## Archive
 -------
 Provides functions to list and extract archives.
-Autosuggestions
+## Autosuggestions
 ---------------
 Integrates zsh-autosuggestions into Prezto.
-Command-Not-Found
+## Command-Not-Found
 -----------------
 Loads the command-not-found tool on macOS or Debian-based distributions.
-Completion
+## Completion
 ----------
-Loads and configures tab completion and provides additional completions from
+Loads and configures <kbd>TAB</kbd> completion and provides additional
-the zsh-completions project.
+completions from the zsh-completions project.
-Directory
+## Directory
 ---------
 Sets directory options and defines directory aliases.
-DNF
+## DNF
 ---
-Defines dnf aliases.
+Defines *dnf* aliases.
-Dpkg
+## Dpkg
 ----
-Defines dpkg aliases and functions.
+Defines *dpkg* aliases and functions.
-Editor
+## Editor
 ------
 Sets key bindings.
-Emacs
+## Emacs
 -----
 Enables Emacs dependency management.
-Environment
+## Environment
 -----------
 Sets general shell options and defines environment variables.
-Fasd
+## Fasd
 ----
 Maintains a frequently used file and directory list for fast access.
-Git
+## Git
 ---
 Enhances the Git distributed version control system by providing aliases,
 functions and by exposing repository status information to prompts.
-GNU Utility
+## GNU Utility
 -----------
 Provides for the interactive use of GNU utilities on non-GNU systems.
-GPG
+## GPG
 ---
 Provides for an easier use of GPG by setting up gpg-agent.
-Haskell
+## Haskell
 -------
 Enables local Haskell package installation.
-Helper
+## Helper
 ------
 Provides helper functions for developing modules.
-History
+## History
 -------
 Sets history options and defines history aliases.
-History Substring Search
+## History Substring Search
 ------------------------
 Integrates zsh-history-substring-search into Prezto.
-Homebrew
+## Homebrew
 --------
 Defines Homebrew aliases.
-MacPorts
+## MacPorts
 --------
 Defines MacPorts aliases and adds MacPorts directories to path variables.
-Node.js
+## Node.js
 -------
 Provides utility functions for Node.js and loads npm completion.
-OCaml
+## OCaml
 -----
 Initializes OCaml package management.
-OSX
+## OSX
 ---
 Defines macOS aliases and functions.
-Pacman
+## Pacman
 ------
 Provides aliases and functions for the Pacman package manager and frontends.
-Perl
+## Perl
 ----
 Enables local Perl module installation on macOS and defines alises.
-Prompt
+## Prompt
 ------
 Loads prompt themes.
-Python
+## Python
 ------
 Enables local Python and local Python package installation.
-Ruby on Rails
+## Ruby on Rails
 -------------
 Defines Ruby on Rails aliases.
-Rsync
+## Rsync
 -----
 Defines rsync aliases.
-Ruby
+## Ruby
 ----
 Configures Ruby local gem installation, loads version managers, and defines
 aliases.
-GNU Screen
+## GNU Screen
 ----------
 Defines GNU Screen aliases and provides for auto launching it at start-up.
-Spectrum
+## Spectrum
 --------
 Provides for easier use of 256 colors and effects.
-SSH
+## SSH
 ---
 Provides for an easier use of SSH by setting up ssh-agent.
-Syntax Highlighting
+## Syntax Highlighting
 -------------------
 Integrates zsh-syntax-highlighting into Prezto.
-Terminal
+## Terminal
 --------
 Sets terminal window and tab titles.
-Tmux
+## Tmux
 ----
 Defines tmux aliases and provides for auto launching it at start-up.
-Utility
+## Utility
 -------
 Defines general aliases and functions.
-Wake-on-LAN
+## Wake-on-LAN
 -----------
 This module provides a wrapper around the wakeonlan tool.
-Yum
+## Yum
 ---
 Defines yum aliases.
--- a/modules/archive/README.md
+++ b/modules/archive/README.md
@ -1,52 +1,47 @@
-Archive
+# Archive
 =======
 Provides functions to create, list, and extract archives.
-Functions
+## Functions
 ---------
-  - `archive` creates an archive based on the provided archive name.
+- `archive` creates an archive based on the provided archive name.
-  - `lsarchive` lists the contents of one or more archives.
+- `lsarchive` lists the contents of one or more archives.
-  - `unarchive` extracts the contents of one or more archives.
+- `unarchive` extracts the contents of one or more archives.
-Supported Formats
+## Supported Formats
 -----------------
 The following archive formats are supported when the required utilities are
 installed:
-  - *.tar.gz*, *.tgz* require `tar` (optionally `pigz`).
+- *.tar.gz*, *.tgz* require `tar` (optionally `pigz`).
-  - *.tar.bz2*, *.tbz* require `tar` (optionally `pbzip2`).
+- *.tar.bz2*, *.tbz* require `tar` (optionally `pbzip2`).
-  - *.tar.xz*, *.txz* require `tar` with *xz* support.
+- *.tar.xz*, *.txz* require `tar` with *xz* support.
-  - *.tar.zma*, *.tlz* require `tar` with *lzma* support.
+- *.tar.zma*, *.tlz* require `tar` with *lzma* support.
-  - *.tar* requires `tar`.
+- *.tar* requires `tar`.
-  - *.gz* requires `gunzip`.
+- *.gz* requires `gunzip`.
-  - *.bz2* requires `bunzip2`.
+- *.bz2* requires `bunzip2`.
-  - *.xz* requires `unxz`.
+- *.xz* requires `unxz`.
-  - *.lzma* requires `unlzma`.
+- *.lzma* requires `unlzma`.
-  - *.Z* requires `uncompress`.
+- *.Z* requires `uncompress`.
-  - *.zip*, *.jar* requires `unzip`.
+- *.zip*, *.jar* requires `unzip`.
-  - *.rar* requires `rar` (needed for `archive` support), `unrar` or `lsar` and `unar`.
+- *.rar* requires `rar` (needed for `archive` support), `unrar` or `lsar` and `unar`.
-  - *.7z* requires `7za`.
+- *.7z* requires `7za`.
-  - *.deb* requires `ar`, `tar`.
+- *.deb* requires `ar`, `tar`.
 Additionally, if `pigz` and/or `pbzip2` are installed, `archive` will use them
 over their traditional counterparts, `gzip` and `bzip2` respectively, to take
 full advantage of all available CPU cores for compression.
-Alternatives
+## Alternatives
 ------------
 Specifically on macOS, [The Unarchiver][1] provides a similar command line tool
 which doesn't depend on a number of other programs being installed.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Matt Hamilton](https://github.com/Eriner)
+- [Matt Hamilton](https://github.com/Eriner)
 [1]: https://theunarchiver.com/command-line
--- a/modules/autosuggestions/README.md
+++ b/modules/autosuggestions/README.md
@ -1,5 +1,4 @@
-Autosuggestions
+# Autosuggestions
 ===============
 Integrates [zsh-autosuggestions][1] into Prezto, which implements the
 [Fish shell][2]'s autosuggestions feature, where the user can type in any part
@ -13,15 +12,13 @@ If this module is used in conjunction with the *history-substring-search*
 module, this module must be loaded **after** the *history-substring-search*
 module.
-Contributors
+## Contributors
 ------------
 New features and bug fixes should be submitted to the [zsh-autosuggestions][1]
 project according to its rules and regulations. This module will be synchronized
 against it.
-Settings
+## Settings
 --------
 ### Highlighting
@ -29,33 +26,31 @@ If colors are enabled, *autosuggestions* will automatically highlight
 positive results.
 To enable highlighting for this module only, add the following line to
-*zpreztorc*:
+*~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:autosuggestions' color 'yes'
 ```
-To set the query found color, add the following line to *zpreztorc*:
+To set the query found color, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:autosuggestions:color' found ''
 ```
-Troubleshooting
+## Troubleshooting
 ---------------
 ### Autosuggestions from previous sessions don't show up
 For autosuggestions from previous shell sessions to work, please make sure you
 also have the `history` module enabled.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/tarruda/zsh-autosuggestions
-[2]: http://fishshell.com
+[2]: https://fishshell.com
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/command-not-found/README.md
+++ b/modules/command-not-found/README.md
@ -1,9 +1,8 @@
-Command-Not-Found
+# Command-Not-Found
 =================
-When you try to use a command that is not available locally, searches
+When you try to use a command that is not available locally, searches the
-the package manager for a package offering that command and suggests
+package manager for a package offering that command and suggests the proper
-the proper install command.
+install command.
 Debian and Arch Linux based distributions use the [`command-not-found`][1] tool.
@ -11,14 +10,12 @@ macOS uses Homebrew's [`command-not-found` clone][2]. Note that unless you have
 a recent version of Homebrew installed, you might also need to tap the
 `command-not-found` Homebrew repository [following the instructions][3].
-
+## Authors
 Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][4].*
-  - [Joseph Booker](https://github.com/sargas)
+- [Joseph Booker](https://github.com/sargas)
-  - [Indrajit Raychaudhuri](https://github.com/indrajitr)
+- [Indrajit Raychaudhuri](https://github.com/indrajitr)
 [1]: https://code.launchpad.net/command-not-found
 [2]: https://github.com/Homebrew/homebrew-command-not-found
--- a/modules/completion/README.md
+++ b/modules/completion/README.md
@ -1,31 +1,29 @@
-Completion
+# Completion
 ==========
-Loads and configures tab completion and provides additional completions from
+Loads and configures <kbd>TAB</kbd> completion and provides additional
-the [zsh-completions][1] project.
+completions from the [zsh-completions][1] project.
 This module must be loaded **after** the *utility* module.
-Options
+## Options
 -------
-  - `COMPLETE_IN_WORD` complete from both ends of a word.
+- `COMPLETE_IN_WORD` complete from both ends of a word.
-  - `ALWAYS_TO_END` move cursor to the end of a completed word.
+- `ALWAYS_TO_END` move cursor to the end of a completed word.
-  - `PATH_DIRS` perform path search even on command names with slashes.
+- `PATH_DIRS` perform path search even on command names with slashes.
-  - `AUTO_MENU` show completion menu on a successive tab press.
+- `AUTO_MENU` show completion menu on a successive <kbd>TAB</kbd> press.
-  - `AUTO_LIST` automatically list choices on ambiguous completion.
+- `AUTO_LIST` automatically list choices on ambiguous completion.
-  - `AUTO_PARAM_SLASH` if completed parameter is a directory, add a trailing slash.
+- `AUTO_PARAM_SLASH` if completed parameter is a directory, add a trailing
-  - `EXTENDED_GLOB` needed for file modification glob modifiers with compinit.
+  slash (`/`).
-  - `MENU_COMPLETE` do not autoselect the first completion entry.
+- `EXTENDED_GLOB` needed for file modification glob modifiers with *compinit*.
-  - `FLOW_CONTROL` disable start/stop characters in shell editor.
+- `MENU_COMPLETE` do not autoselect the first completion entry.
 - `FLOW_CONTROL` disable start/stop characters in shell editor.
-Settings
+## Settings
 --------
 ### Ignore */etc/hosts* Entries
 To ignore certain entries from static */etc/hosts* for host completion, add the
-following lines in *zpreztorc* with the IP addresses of the hosts as they
+following lines in *~/.zpreztorc* with the IP addresses of the hosts as they
 appear in */etc/hosts*. Both IP address and the corresponding hostname will be
 ignored during host completion. However, some of the entries ignored from
 */etc/hosts* still might appear during completion because of their presence in
@ -36,18 +34,16 @@ zstyle ':prezto:module:completion:*:hosts' etc-host-ignores \
  '0.0.0.0' '127.0.0.1'
 ```
-Contributors
+## Contributors
 ------------
-Completions should be submitted to the [zsh-completions][1] project according
+Completions should be submitted to the [zsh-completions][1] project according to
-to its rules and regulations. This module will be synchronized against it.
+its rules and regulations. This module will be synchronized against it.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/zsh-users/zsh-completions
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/directory/README.md
+++ b/modules/directory/README.md
@ -1,34 +1,30 @@
-Directory
+# Directory
 =========
 Sets directory options and defines directory aliases.
-Options
+## Options
 -------
-  - `AUTO_CD` auto changes to a directory without typing `cd`.
+- `AUTO_CD` auto changes to a directory without typing `cd`.
-  - `AUTO_PUSHD` pushes the old directory onto the stack on `cd`.
+- `AUTO_PUSHD` pushes the old directory onto the stack on `cd`.
-  - `PUSHD_IGNORE_DUPS` does not store duplicates in the stack.
+- `PUSHD_IGNORE_DUPS` does not store duplicates in the stack.
-  - `PUSHD_SILENT` does not print the directory stack after `pushd` or `popd`.
+- `PUSHD_SILENT` does not print the directory stack after `pushd` or `popd`.
-  - `PUSHD_TO_HOME` pushes to the home directory when no argument is given.
+- `PUSHD_TO_HOME` pushes to the home directory when no argument is given.
-  - `CDABLE_VARS` changes directory to a path stored in a variable.
+- `CDABLE_VARS` changes directory to a path stored in a variable.
-  - `MULTIOS` writes to multiple descriptors.
+- `MULTIOS` writes to multiple descriptors.
-  - `EXTENDED_GLOB` uses extended globbing syntax.
+- `EXTENDED_GLOB` uses extended globbing syntax.
-  - `CLOBBER` does not overwrite existing files with `>` and `>>`. Use `>!` and
+- `CLOBBER` does not overwrite existing files with `>` and `>>`. Use `>!` and
-    `>>!` to bypass.
+  `>>!` to bypass.
-Aliases
+## Aliases
 -------
-  - `d` prints the contents of the directory stack.
+- `d` prints the contents of the directory stack.
-  - `1 ... 9` changes the directory to the **n** previous one.
+- `1 ... 9` changes the directory to the **n** previous one.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [James Cox](https://github.com/imajes)
+- [James Cox](https://github.com/imajes)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/dnf/README.md
+++ b/modules/dnf/README.md
@ -1,29 +1,25 @@
-DNF
+# DNF
 ===
 Defines [dnf][1] aliases.
-Aliases
+## Aliases
 -------
-  - `dnfc` removes package(s) and leaves.
+- `dnfc` removes package(s) and leaves.
-  - `dnfi` installs package(s).
+- `dnfi` installs package(s).
-  - `dnfh` displays history.
+- `dnfh` displays history.
-  - `dnfl` lists packages.
+- `dnfl` lists packages.
-  - `dnfL` lists installed packages.
+- `dnfL` lists installed packages.
-  - `dnfq` displays package information.
+- `dnfq` displays package information.
-  - `dnfr` removes package(s).
+- `dnfr` removes package(s).
-  - `dnfs` searches for a package.
+- `dnfs` searches for a package.
-  - `dnfu` updates packages.
+- `dnfu` updates packages.
-  - `dnfU` upgrades packages.
+- `dnfU` upgrades packages.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://fedoraproject.org/wiki/Features/DNF
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/docker/README.md
+++ b/modules/docker/README.md
@ -1,4 +1,4 @@
-# ZSH Docker Aliases
+# Docker
 Defines [Docker][1] aliases and functions.
@ -21,14 +21,15 @@ Defines [Docker][1] aliases and functions.
 - `dkli` Log in to a Docker registry
 - `dklo` Log out from a Docker registry
 - `dkls` is alias for `dkps`
- `dkp` Pause all processes within one or more containers<Paste>
+- `dkp` Pause all processes within one or more containers
 - `dkP` Unpause all processes within one or more containers
 - `dkpl` Pull an image or a repository from a registry
 - `dkph` Push an image or a repository to a registry
 - `dkps` List containers
 - `dkpsa` List all containers (default lists just running)
 - `dkr` Run a command in a new container
- `dkR` Run an interactive command in a new container and automatically remove the container when it exits
+- `dkR` Run an interactive command in a new container and automatically remove
  the container when it exits
 - `dkRe` like `dkR` and set entry point to `/bin/bash`
 - `dkrm` Remove one or more containers
 - `dkrmi` Remove one or more images
@ -39,13 +40,14 @@ Defines [Docker][1] aliases and functions.
 - `dks` Start one or more stopped containers
 - `dkS` Restart a container
 - `dkss` Display a live stream of container(s) resource usage statistics
- `dksv` Save one or more images to a tar archive (streamed to STDOUT by default)
+- `dksv` Save one or more images to a tar archive (streamed to STDOUT by
  default)
 - `dkt` Tag an image into a repository
 - `dktop` Display the running processes of a container
 - `dkup` Update configuration of one or more containers
 - `dkV` Manage Docker volumes
 - `dkv` Show the Docker version information
- `dkw` Block until a container stops, then print its exit code<Paste>
+- `dkw` Block until a container stops, then print its exit code
 - `dkx` Stop a running container
 #### container (C)
@ -65,7 +67,8 @@ Defines [Docker][1] aliases and functions.
 - `dkCS` Restart one or more containers
 - `dkCrm` Remove one or more containers
 - `dkCr` Run a command in a new container
- `dkCR` Run an interactive command in a new container and automatically remove the container when it exits
+- `dkCR` Run an interactive command in a new container and automatically remove
  the container when it exits
 - `dkCRe` like `dkCR` and set entry point to `/bin/bash`
 - `dkCs` Start one or more stopped containers
 - `dkCss` Display a live stream of container(s) resource usage statistics
@ -87,7 +90,8 @@ Defines [Docker][1] aliases and functions.
 - `dkIpl` Pull an image or a repository from a registry
 - `dkIph` Push an image or a repository to a registry
 - `dkIrm` Remove one or more images
- `dkIsv` Save one or more images to a tar archive (streamed to STDOUT by default)
+- `dkIsv` Save one or more images to a tar archive (streamed to STDOUT by
  default)
 - `dkIt` Tag an image into a repository
 #### volume (V)
--- a/modules/dpkg/README.md
+++ b/modules/dpkg/README.md
@ -1,10 +1,8 @@
-Dpkg
+# Dpkg
 ====
-Defines [dpkg][1] aliases and functions.
+Defines [*dpkg*][1] aliases and functions.
-Aliases
+## Aliases
 -------
 - `debc` cleans the cache.
 - `debf` displays a file's package.
@ -20,22 +18,20 @@ Aliases
 - `deb-kclean` removes all kernel images and headers, except for the ones in
  use.
-Functions
+## Functions
 ---------
- `deb-clone` generates a script that can be used to duplicate a dpkg-based
+- `deb-clone` generates a script that can be used to duplicate a `dpkg`-based
  system.
- `deb-history` displays dpkg history.
+- `deb-history` displays `dpkg` history.
- `deb-kbuild` makes a dpkg Linux kernel package.
+- `deb-kbuild` makes a `dpkg` Linux kernel package.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Daniel Bolton](https://github.com/dbb)
+- [Daniel Bolton](https://github.com/dbb)
-  - [Benjamin Boudreau](https://github.com/dreur)
+- [Benjamin Boudreau](https://github.com/dreur)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://wiki.debian.org/Teams/Dpkg
+[1]: https://wiki.debian.org/Teams/Dpkg
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/editor/README.md
+++ b/modules/editor/README.md
@ -1,25 +1,21 @@
-Editor
+# Editor
 ======
 Sets editor specific key bindings options and variables.
-Options
+## Options
 -------
-  - `BEEP` beep on error in line editor.
+- `BEEP` beep on error in line editor.
-Variables
+## Variables
 ---------
-  - `WORDCHARS` treat a given set of characters as part of a word.
+- `WORDCHARS` treat a given set of characters as part of a word.
-Settings
+## Settings
 --------
 ### Key bindings
-To enable key bindings, add the following to *zpreztorc*, and replace 'bindings'
+To enable key bindings, add the following to *~/.zpreztorc*, and replace
-with 'emacs' or 'vi'.
+'bindings' with 'emacs' or 'vi'.
 ```sh
 zstyle ':prezto:module:editor' key-bindings 'bindings'
@ -28,7 +24,7 @@ zstyle ':prezto:module:editor' key-bindings 'bindings'
 ### Dot Expansion
 To enable the auto conversion of .... to ../.., add the following to
-*zpreztorc*.
+*~/.zpreztorc*.
 ```sh
 zstyle ':prezto:module:editor' dot-expansion 'yes'
@ -37,14 +33,13 @@ zstyle ':prezto:module:editor' dot-expansion 'yes'
 ### PS Context
 To enable the prompt context to be set, add the following to your
-*zpreztorc*.
+*~/.zpreztorc*.
 ```sh
 zstyle ':prezto:module:editor' ps-context 'yes'
 ```
-Theming
+## Theming
 -------
 To indicate when the editor is in the primary keymap (emacs or viins), add
 the following to your `theme_prompt_setup` function.
@ -84,8 +79,7 @@ zstyle ':prezto:module:editor:info:completing' format '...'
 Then add `$editor_info[context]`, where context is *keymap*, *insert*, or
 *overwrite*, to `$PROMPT` or `$RPROMPT`.
-Convenience Functions
+## Convenience Functions
 ---------------------
 ### bindkey-all
@ -99,11 +93,10 @@ It will also pass through arguments so you can use bindkey-all to set bindings
 for all keymaps at once. If provided arguments it will *not* print out the
 names of each of the keymaps, and just run the command for each keymap.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/emacs/README.md
+++ b/modules/emacs/README.md
@ -1,10 +1,8 @@
-Emacs
+# Emacs
 =====
 Enables Emacs dependency management.
-Dependency management
+## Dependency management
 ---------------------
 [Carton][1] installs and manages Emacs packages for Emacs package development
 and Emacs configuration.
@ -12,22 +10,20 @@ and Emacs configuration.
 This module prepends the Carton directory to the path variable to enable the
 execution of `carton`.
-Aliases
+## Aliases
 -------
 ### Carton
-  - `cai` installs dependencies.
+- `cai` installs dependencies.
-  - `cau` updates dependencies.
+- `cau` updates dependencies.
-  - `caI` initializes the current directory for dependency management.
+- `caI` initializes the current directory for dependency management.
-  - `cae` executes a command which correct dependencies.
+- `cae` executes a command which correct dependencies.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sebastian Wiesner](https://github.com/lunaryorn)
+- [Sebastian Wiesner](https://github.com/lunaryorn)
 [1]: https://github.com/rejeep/carton
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/environment/README.md
+++ b/modules/environment/README.md
@ -1,56 +1,51 @@
-Environment
+# Environment
 ===========
 Sets general shell options and defines environment variables.
 This module must be loaded first.
-Contributors
+## Contributors
 ------------
 This module **MUST NOT** rely on any command not built in Zsh.
 Non-interactive environment variables should be defined in [`zshenv`][1].
-Options
+## Options
 -------
 ### General
-  - `COMBINING_CHARS` combine zero-length punctuation characters (accents) with
+- `COMBINING_CHARS` combine zero-length punctuation characters (accents) with
-    the base character.
+  the base character.
-  - `INTERACTIVE_COMMENTS` enable comments in interactive shell.
+- `INTERACTIVE_COMMENTS` enable comments in interactive shell.
-  - `RC_QUOTES` allow 'Henry''s Garage' instead of 'Henry'\''s Garage'.
+- `RC_QUOTES` allow 'Henry''s Garage' instead of 'Henry'\''s Garage'.
-  - `MAIL_WARNING` don't print a warning message if a mail file has been accessed.
+- `MAIL_WARNING` don't print a warning message if a mail file has been accessed.
 ### Jobs
-  - `LONG_LIST_JOBS` list jobs in the long format by default.
+- `LONG_LIST_JOBS` list jobs in the long format by default.
-  - `AUTO_RESUME` attempt to resume existing job before creating a new process.
+- `AUTO_RESUME` attempt to resume existing job before creating a new process.
-  - `NOTIFY` report status of background jobs immediately.
+- `NOTIFY` report status of background jobs immediately.
-  - `BG_NICE` don't run all background jobs at a lower priority.
+- `BG_NICE` don't run all background jobs at a lower priority.
-  - `HUP` don't kill jobs on shell exit.
+- `HUP` don't kill jobs on shell exit.
-  - `CHECK_JOBS` don't report on jobs when shell exit.
+- `CHECK_JOBS` don't report on jobs when shell exit.
-Variables
+## Variables
 ---------
 ### Termcap
-  - `LESS_TERMCAP_mb` begins blinking.
+- `LESS_TERMCAP_mb` begins blinking.
-  - `LESS_TERMCAP_md` begins bold.
+- `LESS_TERMCAP_md` begins bold.
-  - `LESS_TERMCAP_me` ends mode.
+- `LESS_TERMCAP_me` ends mode.
-  - `LESS_TERMCAP_se` ends standout-mode.
+- `LESS_TERMCAP_se` ends standout-mode.
-  - `LESS_TERMCAP_so` begins standout-mode.
+- `LESS_TERMCAP_so` begins standout-mode.
-  - `LESS_TERMCAP_ue` ends underline.
+- `LESS_TERMCAP_ue` ends underline.
-  - `LESS_TERMCAP_us` begins underline.
+- `LESS_TERMCAP_us` begins underline.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/blob/master/runcoms/zshenv
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/fasd/README.md
+++ b/modules/fasd/README.md
@ -1,5 +1,4 @@
-Fasd
+# Fasd
 ====
 [Fasd][1] is a command-line productivity booster, inspired by tools like
 [autojump][2], [z][3] and [v][4], it offers quick access to files and
@ -12,30 +11,27 @@ module.
 The Prezto Fasd configuration differs from the default. The default aliases have
 been disabled.
-Installation
+## Installation
 ------------
-`fasd` is bundled with prezto as a git submodule. Alternatively, you can manually install `fasd`.
+`fasd` is bundled with prezto as a git submodule. Alternatively, you can
-If a manual install is found, it will be used instead of the bundled version.
+manually install `fasd`. If a manual installation is found, it will be used
 instead of the bundled version.
-Aliases
+## Aliases
 -------
-  - `j` changes the current working directory interactively.
+- `j` changes the current working directory interactively.
-Completion
+## Completion
 ----------
 Type `,`, `f,`, `d,` in front of a comma-separated query or type `,,`,  `,,f`,
-`,,d` at the end of a comma-separated query then hit <kbd>tab</kbd>.
+`,,d` at the end of a comma-separated query then hit <kbd>TAB</kbd>.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][5].*
-  - [Wei Dai](https://github.com/clvv)
+- [Wei Dai](https://github.com/clvv)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/clvv/fasd
 [2]: https://github.com/joelthelion/autojump
--- a/modules/git/README.md
+++ b/modules/git/README.md
@ -1,13 +1,11 @@
-Git
+# Git
 ===
 Enhances the [Git][1] distributed version control system by providing aliases,
 functions and by exposing repository status information to prompts.
 Git **1.7.2** is the [minimum required version][7].
-Settings
+## Settings
 --------
 ### Log
@ -30,8 +28,7 @@ zstyle ':prezto:module:git:status:ignore' submodules 'all'
 This setting affects all aliases and functions that call `git-status`.
-Aliases
+## Aliases
 -------
 Aliases are enabled by default. You can disable them with:
@ -41,288 +38,290 @@ zstyle ':prezto:module:git:alias' skip 'yes'
 ### Git
-  - `g` is short for `git`.
+- `g` is short for `git`.
-
+
-### Branch
+### Branch (b)
-
+
-  - `gb` lists, creates, renames, and deletes branches.
+- `gb` lists, creates, renames, and deletes branches.
-  - `gbc` creates a new branch.
+- `gbc` creates a new branch.
-  - `gbl` lists branches and their commits. (also `gbv`)
+- `gbl` lists branches and their commits. (also `gbv`)
-  - `gbL` lists all local and remote branches and their commits.
+- `gbL` lists all local and remote branches and their commits.
-  - `gbr` renames a branch. (also `gbm`)
+- `gbr` renames a branch. (also `gbm`)
-  - `gbR` renames a branch even if the new branch name already exists. (also
+- `gbR` renames a branch even if the new branch name already exists. (also
-    `gbM`)
+  `gbM`)
-  - `gbs` lists branches and their commits with ancestry graphs.
+- `gbs` lists branches and their commits with ancestry graphs.
-  - `gbS` lists local and remote branches and their commits with ancestry
+- `gbS` lists local and remote branches and their commits with ancestry graphs.
-    graphs.
+- `gbV` lists branches with more verbose information about their commits.
-  - `gbV` lists branches with more verbose information about their commits.
+- `gbx` deletes a branch. (also `gbd`)
-  - `gbx` deletes a branch. (also `gbd`)
+- `gbX` deletes a branch irrespective of its merged status. (also `gbD`)
-  - `gbX` deletes a branch irrespective of its merged status. (also `gbD`)
+
-
+### Commit (c)
-
+
-### Commit
+- `gc` records changes to the repository.
-
+- `gca` stages all modified and deleted files.
-  - `gc` records changes to the repository.
+- `gcm` records changes to the repository with the given message.
-  - `gca` stages all modified and deleted files.
+- `gcS` records changes to the repository. (Signed)
-  - `gcm` records changes to the repository with the given message.
+- `gcSa` stages all modified and deleted files. (Signed)
-  - `gcS` records changes to the repository. (Signed)
+- `gcSm` records changes to the repository with the given message. (Signed)
-  - `gcSa` stages all modified and deleted files. (Signed)
+- `gcam` stages all modified and deleted files, and records changes to the
-  - `gcSm` records changes to the repository with the given message. (Signed)
+  repository with the given message.
-  - `gcam` stages all modified and deleted files, and records changes to the repository with the given message.
+- `gco` checks out a branch or paths to work tree.
-  - `gco` checks out a branch or paths to work tree.
+- `gcO` checks out hunks from the index or the tree interactively.
-  - `gcO` checks out hunks from the index or the tree interactively.
+- `gcf` amends the tip of the current branch using the same log message as
-  - `gcf` amends the tip of the current branch using the same log message as *HEAD*.
+  *HEAD*.
-  - `gcSf` amends the tip of the current branch using the same log message as *HEAD*. (Signed)
+- `gcSf` amends the tip of the current branch using the same log message as
-  - `gcF` amends the tip of the current branch.
+  *HEAD*. (Signed)
-  - `gcSF` amends the tip of the current branch. (Signed)
+- `gcF` amends the tip of the current branch.
-  - `gcp` applies changes introduced by existing commits.
+- `gcSF` amends the tip of the current branch. (Signed)
-  - `gcP` applies changes introduced by existing commits without committing.
+- `gcp` applies changes introduced by existing commits.
-  - `gcr` reverts existing commits by reverting patches and recording new
+- `gcP` applies changes introduced by existing commits without committing.
-     commits.
+- `gcr` reverts existing commits by reverting patches and recording new commits.
-  - `gcR` removes the *HEAD* commit.
+- `gcR` removes the *HEAD* commit.
-  - `gcs` displays various types of objects.
+- `gcs` displays various types of objects.
-  - `gcsS` displays commits with GPG signature.
+- `gcsS` displays commits with GPG signature.
-  - `gcl` lists lost commits.
+- `gcl` lists lost commits.
-  - `gcy` displays commits yet to be applied to upstream in the short format.
+- `gcy` displays commits yet to be applied to upstream in the short format.
-  - `gcY` displays commits yet to be applied to upstream.
+- `gcY` displays commits yet to be applied to upstream.
-
+
-### Conflict
+### Conflict (C)
-
+
-  - `gCl` lists unmerged files.
+- `gCl` lists unmerged files.
-  - `gCa` adds unmerged file contents to the index.
+- `gCa` adds unmerged file contents to the index.
-  - `gCe` executes merge-tool on all unmerged file.
+- `gCe` executes merge-tool on all unmerged file.
-  - `gCo` checks out our changes for unmerged paths.
+- `gCo` checks out our changes for unmerged paths.
-  - `gCO` checks out our changes for all unmerged paths.
+- `gCO` checks out our changes for all unmerged paths.
-  - `gCt` checks out their changes for unmerged paths.
+- `gCt` checks out their changes for unmerged paths.
-  - `gCT` checks out their changes for all unmerged paths.
+- `gCT` checks out their changes for all unmerged paths.
-
+
-### Data
+### Data (d)
-
+
-  - `gd` displays information about files in the index and the work tree.
+- `gd` displays information about files in the index and the work tree.
-  - `gdc` lists cached files.
+- `gdc` lists cached files.
-  - `gdx` lists deleted files.
+- `gdx` lists deleted files.
-  - `gdm` lists modified files.
+- `gdm` lists modified files.
-  - `gdu` lists untracked files.
+- `gdu` lists untracked files.
-  - `gdk` lists killed files.
+- `gdk` lists killed files.
-  - `gdi` lists ignored files.
+- `gdi` lists ignored files.
-
+
-### Fetch
+### Fetch (f)
-
+
-  - `gf` downloads objects and references from another repository.
+- `gf` downloads objects and references from another repository.
-  - `gfa` downloads objects and references from all remote repositories.
+- `gfa` downloads objects and references from all remote repositories.
-  - `gfc` clones a repository into a new directory.
+- `gfc` clones a repository into a new directory.
-  - `gfcr` clones a repository into a new directory including all submodules.
+- `gfcr` clones a repository into a new directory including all submodules.
-  - `gfm` fetches from and merges with another repository or local branch.
+- `gfm` fetches from and merges with another repository or local branch.
-  - `gfr` fetches from and rebases on another repository or local branch.
+- `gfr` fetches from and rebases on another repository or local branch.
-
+
-### Flow
+### Flow (F)
-
+
-  - `gFi` is short for `git flow init`
+- `gFi` is short for `git flow init`
-
+
-#### Feature
+#### Feature (Ff)
-
+
-  - `gFf` is short for `git flow feature`
+- `gFf` is short for `git flow feature`
-  - `gFfl` is short for `git flow feature list`
+- `gFfl` is short for `git flow feature list`
-  - `gFfs` is short for `git flow feature start`
+- `gFfs` is short for `git flow feature start`
-  - `gFff` is short for `git flow feature finish`
+- `gFff` is short for `git flow feature finish`
-  - `gFfp` is short for `git flow feature publish`
+- `gFfp` is short for `git flow feature publish`
-  - `gFft` is short for `git flow feature track`
+- `gFft` is short for `git flow feature track`
-  - `gFfd` is short for `git flow feature diff`
+- `gFfd` is short for `git flow feature diff`
-  - `gFfr` is short for `git flow feature rebase`
+- `gFfr` is short for `git flow feature rebase`
-  - `gFfc` is short for `git flow feature checkout`
+- `gFfc` is short for `git flow feature checkout`
-  - `gFfm` is short for `git flow feature pull`
+- `gFfm` is short for `git flow feature pull`
-  - `gFfx` is short for `git flow feature delete`
+- `gFfx` is short for `git flow feature delete`
-
+
-#### Bugfix
+#### Bugfix (Fb)
-
+
-  - `gFb` is short for `git flow bugfix`
+- `gFb` is short for `git flow bugfix`
-  - `gFbl` is short for `git flow bugfix list`
+- `gFbl` is short for `git flow bugfix list`
-  - `gFbs` is short for `git flow bugfix start`
+- `gFbs` is short for `git flow bugfix start`
-  - `gFbf` is short for `git flow bugfix finish`
+- `gFbf` is short for `git flow bugfix finish`
-  - `gFbp` is short for `git flow bugfix publish`
+- `gFbp` is short for `git flow bugfix publish`
-  - `gFbt` is short for `git flow bugfix track`
+- `gFbt` is short for `git flow bugfix track`
-  - `gFbd` is short for `git flow bugfix diff`
+- `gFbd` is short for `git flow bugfix diff`
-  - `gFbr` is short for `git flow bugfix rebase`
+- `gFbr` is short for `git flow bugfix rebase`
-  - `gFbc` is short for `git flow bugfix checkout`
+- `gFbc` is short for `git flow bugfix checkout`
-  - `gFbm` is short for `git flow bugfix pull`
+- `gFbm` is short for `git flow bugfix pull`
-  - `gFbx` is short for `git flow bugfix delete`
+- `gFbx` is short for `git flow bugfix delete`
-
+
-#### Release
+#### Release (Fl)
-
+
-  - `gFl` is short for `git flow release`
+- `gFl` is short for `git flow release`
-  - `gFll` is short for `git flow release list`
+- `gFll` is short for `git flow release list`
-  - `gFls` is short for `git flow release start`
+- `gFls` is short for `git flow release start`
-  - `gFlf` is short for `git flow release finish`
+- `gFlf` is short for `git flow release finish`
-  - `gFlp` is short for `git flow release publish`
+- `gFlp` is short for `git flow release publish`
-  - `gFlt` is short for `git flow release track`
+- `gFlt` is short for `git flow release track`
-  - `gFld` is short for `git flow release diff`
+- `gFld` is short for `git flow release diff`
-  - `gFlr` is short for `git flow release rebase`
+- `gFlr` is short for `git flow release rebase`
-  - `gFlc` is short for `git flow release checkout`
+- `gFlc` is short for `git flow release checkout`
-  - `gFlm` is short for `git flow release pull`
+- `gFlm` is short for `git flow release pull`
-  - `gFlx` is short for `git flow release delete`
+- `gFlx` is short for `git flow release delete`
-
+
-#### Hotfix
+#### Hotfix (Fh)
-
+
-  - `gFh` is short for `git flow hotfix`
+- `gFh` is short for `git flow hotfix`
-  - `gFhl` is short for `git flow hotfix list`
+- `gFhl` is short for `git flow hotfix list`
-  - `gFhs` is short for `git flow hotfix start`
+- `gFhs` is short for `git flow hotfix start`
-  - `gFhf` is short for `git flow hotfix finish`
+- `gFhf` is short for `git flow hotfix finish`
-  - `gFhp` is short for `git flow hotfix publish`
+- `gFhp` is short for `git flow hotfix publish`
-  - `gFht` is short for `git flow hotfix track`
+- `gFht` is short for `git flow hotfix track`
-  - `gFhd` is short for `git flow hotfix diff`
+- `gFhd` is short for `git flow hotfix diff`
-  - `gFhr` is short for `git flow hotfix rebase`
+- `gFhr` is short for `git flow hotfix rebase`
-  - `gFhc` is short for `git flow hotfix checkout`
+- `gFhc` is short for `git flow hotfix checkout`
-  - `gFhm` is short for `git flow hotfix pull`
+- `gFhm` is short for `git flow hotfix pull`
-  - `gFhx` is short for `git flow hotfix delete`
+- `gFhx` is short for `git flow hotfix delete`
-
+
-#### Support
+#### Support (Fs)
-
+
-  - `gFs` is short for `git flow support`
+- `gFs` is short for `git flow support`
-  - `gFsl` is short for `git flow support list`
+- `gFsl` is short for `git flow support list`
-  - `gFss` is short for `git flow support start`
+- `gFss` is short for `git flow support start`
-  - `gFsf` is short for `git flow support finish`
+- `gFsf` is short for `git flow support finish`
-  - `gFsp` is short for `git flow support publish`
+- `gFsp` is short for `git flow support publish`
-  - `gFst` is short for `git flow support track`
+- `gFst` is short for `git flow support track`
-  - `gFsd` is short for `git flow support diff`
+- `gFsd` is short for `git flow support diff`
-  - `gFsr` is short for `git flow support rebase`
+- `gFsr` is short for `git flow support rebase`
-  - `gFsc` is short for `git flow support checkout`
+- `gFsc` is short for `git flow support checkout`
-  - `gFsm` is short for `git flow support pull`
+- `gFsm` is short for `git flow support pull`
-  - `gFsx` is short for `git flow support delete`
+- `gFsx` is short for `git flow support delete`
-
+
-### Grep
+### Grep (g)
-
+
-  - `gg` displays lines matching a pattern.
+- `gg` displays lines matching a pattern.
-  - `ggi` displays lines matching a pattern ignoring case.
+- `ggi` displays lines matching a pattern ignoring case.
-  - `ggl` lists files matching a pattern.
+- `ggl` lists files matching a pattern.
-  - `ggL` lists files that are not matching a pattern.
+- `ggL` lists files that are not matching a pattern.
-  - `ggv` displays lines not matching a pattern.
+- `ggv` displays lines not matching a pattern.
-  - `ggw` displays lines matching a pattern at word boundary.
+- `ggw` displays lines matching a pattern at word boundary.
-
+
-### Index
+### Index (i)
-
+
-  - `gia` adds file contents to the index.
+- `gia` adds file contents to the index.
-  - `giA` adds file contents to the index interactively.
+- `giA` adds file contents to the index interactively.
-  - `giu` adds file contents to the index (updates only known files).
+- `giu` adds file contents to the index (updates only known files).
-  - `gid` displays changes between the index and a named commit (diff).
+- `gid` displays changes between the index and a named commit (diff).
-  - `giD` displays changes between the index and a named commit (word diff).
+- `giD` displays changes between the index and a named commit (word diff).
-  - `gii` temporarily ignore differences in a given file.
+- `gii` temporarily ignore differences in a given file.
-  - `giI` unignore differences in a given file.
+- `giI` unignore differences in a given file.
-  - `gir` resets the current HEAD to the specified state.
+- `gir` resets the current HEAD to the specified state.
-  - `giR` resets the current index interactively.
+- `giR` resets the current index interactively.
-  - `gix` removes files/directories from the index (recursively).
+- `gix` removes files/directories from the index (recursively).
-  - `giX` removes files/directories from the index (recursively and forced).
+- `giX` removes files/directories from the index (recursively and forced).
-
+
-### Log
+### Log (l)
-
+
-  - `gl` displays the log.
+- `gl` displays the log.
-  - `gls` displays the stats log.
+- `gls` displays the stats log.
-  - `gld` displays the diff log.
+- `gld` displays the diff log.
-  - `glo` displays the one line log.
+- `glo` displays the one line log.
-  - `glg` displays the graph log.
+- `glg` displays the graph log.
-  - `glb` displays the brief commit log.
+- `glb` displays the brief commit log.
-  - `glc` displays the commit count for each contributor in descending order.
+- `glc` displays the commit count for each contributor in descending order.
-  - `glS` displays the log and checks the validity of signed commits.
+- `glS` displays the log and checks the validity of signed commits.
-
+
-### Merge
+### Merge (m)
-
+
-  - `gm` joins two or more development histories together.
+- `gm` joins two or more development histories together.
-  - `gmC` joins two or more development histories together but does not commit.
+- `gmC` joins two or more development histories together but does not commit.
-  - `gmF` joins two or more development histories together but does not commit
+- `gmF` joins two or more development histories together but does not commit
-     generating a merge commit even if the merge resolved as a fast-forward.
+  generating a merge commit even if the merge resolved as a fast-forward.
-  - `gma` aborts the conflict resolution, and reconstructs the pre-merge state.
+- `gma` aborts the conflict resolution, and reconstructs the pre-merge state.
-  - `gmt` runs the merge conflict resolution tools to resolve conflicts.
+- `gmt` runs the merge conflict resolution tools to resolve conflicts.
-
+
-### Push
+### Push (p)
-
+
-  - `gp` updates remote refs along with associated objects.
+- `gp` updates remote refs along with associated objects.
-  - `gpf` forcefully updates remote refs along with associated objects using the safer `--force-with-lease` option.
+- `gpf` forcefully updates remote refs along with associated objects using the
-  - `gpF` forcefully updates remote refs along with associated objects using the riskier `--force` option.
+  safer `--force-with-lease` option.
-  - `gpa` updates remote branches along with associated objects.
+- `gpF` forcefully updates remote refs along with associated objects using the
-  - `gpA` updates remote branches and tags along with associated objects.
+  riskier `--force` option.
-  - `gpt` updates remote tags along with associated objects.
+- `gpa` updates remote branches along with associated objects.
-  - `gpc` updates remote refs along with associated objects and adds *origin*
+- `gpA` updates remote branches and tags along with associated objects.
-     as an upstream reference for the current branch.
+- `gpt` updates remote tags along with associated objects.
-  - `gpp` pulls and pushes from origin to origin.
+- `gpc` updates remote refs along with associated objects and adds *origin* as
-
+  an upstream reference for the current branch.
-### Rebase
+- `gpp` pulls and pushes from origin to origin.
-
+
-  - `gr` forward-ports local commits to the updated upstream head.
+### Rebase (r)
-  - `gra` aborts the rebase.
+
-  - `grc` continues the rebase after merge conflicts are resolved.
+- `gr` forward-ports local commits to the updated upstream head.
-  - `gri` makes a list of commits to be rebased and opens the editor.
+- `gra` aborts the rebase.
-  - `grs` skips the current patch.
+- `grc` continues the rebase after merge conflicts are resolved.
-
+- `gri` makes a list of commits to be rebased and opens the editor.
-### Remote
+- `grs` skips the current patch.
-
+
-  - `gR` manages tracked repositories.
+### Remote (R)
-  - `gRl` lists remote names and their URLs.
+
-  - `gRa` adds a new remote.
+- `gR` manages tracked repositories.
-  - `gRx` removes a remote.
+- `gRl` lists remote names and their URLs.
-  - `gRm` renames a remote.
+- `gRa` adds a new remote.
-  - `gRu` fetches remotes updates.
+- `gRx` removes a remote.
-  - `gRp` prunes all stale remote tracking branches.
+- `gRm` renames a remote.
-  - `gRs` displays information about a given remote.
+- `gRu` fetches remotes updates.
-  - `gRb` opens a remote on [GitHub][3] in the default browser.
+- `gRp` prunes all stale remote tracking branches.
-
+- `gRs` displays information about a given remote.
-### Stash
+- `gRb` opens a remote on [GitHub][3] in the default browser.
-
+
-  - `gs` stashes the changes of the dirty working directory.
+### Stash (s)
-  - `gsa` applies the changes recorded in a stash to the working directory.
+
-  - `gsx` drops a stashed state.
+- `gs` stashes the changes of the dirty working directory.
-  - `gsX` drops all the stashed states.
+- `gsa` applies the changes recorded in a stash to the working directory.
-  - `gsl` lists stashed states.
+- `gsx` drops a stashed state.
-  - `gsL` lists dropped stashed states.
+- `gsX` drops all the stashed states.
-  - `gsd` displays changes between the stash and its original parent.
+- `gsl` lists stashed states.
-  - `gsp` removes and applies a single stashed state from the stash list.
+- `gsL` lists dropped stashed states.
-  - `gsr` recovers a given stashed state.
+- `gsd` displays changes between the stash and its original parent.
-  - `gss` stashes the changes of the dirty working directory, including untracked.
+- `gsp` removes and applies a single stashed state from the stash list.
-  - `gsS` stashes the changes of the dirty working directory interactively.
+- `gsr` recovers a given stashed state.
-  - `gsw` stashes the changes of the dirty working directory retaining the index.
+- `gss` stashes the changes of the dirty working directory, including untracked.
-
+- `gsS` stashes the changes of the dirty working directory interactively.
-### Submodule
+- `gsw` stashes the changes of the dirty working directory retaining the index.
-
+
-  - `gS` initializes, updates, or inspects submodules.
+### Submodule (S)
-  - `gSa` adds given a repository as a submodule.
+
-  - `gSf` evaluates a shell command in each of checked out submodules.
+- `gS` initializes, updates, or inspects submodules.
-  - `gSi` initializes submodules.
+- `gSa` adds given a repository as a submodule.
-  - `gSI` initializes and clones submodules recursively.
+- `gSf` evaluates a shell command in each of checked out submodules.
-  - `gSl` lists the commits of all submodules.
+- `gSi` initializes submodules.
-  - `gSm` moves a submodule.
+- `gSI` initializes and clones submodules recursively.
-  - `gSs` synchronizes submodules' remote URL to the value specified in
+- `gSl` lists the commits of all submodules.
-    .gitmodules.
+- `gSm` moves a submodule.
-  - `gSu` fetches and merges the latest changes for all submodule.
+- `gSs` synchronizes submodules' remote URL to the value specified in
-  - `gSx` removes a submodule.
+  *.gitmodules*.
-
+- `gSu` fetches and merges the latest changes for all submodule.
-### Tag
+- `gSx` removes a submodule.
-
+
-  - `gt` lists tags or creates tag.
+### Tag (t)
-  - `gtl` lists tags matching pattern.
+
-  - `gts` creates a signed tag.
+- `gt` lists tags or creates tag.
-  - `gtv` validate a signed tag.
+- `gtl` lists tags matching pattern.
-
+- `gts` creates a signed tag.
-### Working directory
+- `gtv` validate a signed tag.
-
+
-  - `gws` displays working-tree status in the short format.
+### Working directory (w)
-  - `gwS` displays working-tree status.
+
-  - `gwd` displays changes between the working tree and the index (diff).
+- `gws` displays working-tree status in the short format.
-  - `gwD` displays changes between the working tree and the index (word diff).
+- `gwS` displays working-tree status.
-  - `gwr` resets the current HEAD to the specified state, does not touch the
+- `gwd` displays changes between the working tree and the index (diff).
-     index nor the working tree.
+- `gwD` displays changes between the working tree and the index (word diff).
-  - `gwR` resets the current HEAD, index and working tree to the specified state.
+- `gwr` resets the current HEAD to the specified state, does not touch the
-  - `gwc` removes untracked files from the working tree (dry-run).
+  index nor the working tree.
-  - `gwC` removes untracked files from the working tree.
+- `gwR` resets the current HEAD, index and working tree to the specified state.
-  - `gwx` removes files from the working tree and from the index recursively.
+- `gwc` removes untracked files from the working tree (dry-run).
-  - `gwX` removes files from the working tree and from the index recursively and
+- `gwC` removes untracked files from the working tree.
-    forcefully.
+- `gwx` removes files from the working tree and from the index recursively.
 - `gwX` removes files from the working tree and from the index recursively and
  forcefully.
 ### Shadows
 The following aliases may shadow system commands:
-  - `gb` shadows the [GB][9].
+- `gb` shadows the [GB][9].
-  - `gm` shadows the [Graphics Magick image processor][11].
+- `gm` shadows the [GraphicsMagick image processor][11].
-  - `gpt` shadows the [GUID partition table maintenance utility][4].
+- `gpt` shadows the [GUID partition table maintenance utility][4].
-  - `gs` shadows the [Ghostscript interpreter and previewer][5].
+- `gs` shadows the [Ghostscript interpreter and previewer][5].
 If you frequently use the above commands, you may wish to remove said aliases
 from this module or to disable them at the bottom of the zshrc with `unalias`.
@ -330,25 +329,23 @@ from this module or to disable them at the bottom of the zshrc with `unalias`.
 You can temporarily bypass an alias by prefixing it with a backward slash:
 `\gpt`.
-Functions
+## Functions
---------
+
-
+- `git-branch-current` displays the current branch.
-  - `git-branch-current` displays the current branch.
+- `git-commit-lost` lists lost commits.
-  - `git-commit-lost` lists lost commits.
+- `git-dir` displays the path to the Git directory.
-  - `git-dir` displays the path to the Git directory.
+- `git-hub-browse` opens the [GitHub][3] repository in the default browser.
-  - `git-hub-browse` opens the [GitHub][3] repository in the default browser.
+- `git-hub-shorten-url` shortens [GitHub URLs][10].
-  - `git-hub-shorten-url` shortens [GitHub URLs][10].
+- `git-info` exposes repository information via the `$git_info` associative
-  - `git-info` exposes repository information via the `$git_info` associative
+  array.
-    array.
+- `git-root` displays the path to the working tree root.
-  - `git-root` displays the path to the working tree root.
+- `git-stash-clear-interactive` asks for confirmation before clearing the stash.
-  - `git-stash-clear-interactive` asks for confirmation before clearing the stash.
+- `git-stash-dropped` lists dropped stashed states.
-  - `git-stash-dropped` lists dropped stashed states.
+- `git-stash-recover` recovers given dropped stashed states.
-  - `git-stash-recover` recovers given dropped stashed states.
+- `git-submodule-move` moves a submodule.
-  - `git-submodule-move` moves a submodule.
+- `git-submodule-remove` removes a submodule.
-  - `git-submodule-remove` removes a submodule.
+
-
+## Theming
 Theming
 -------
 To display information about the current repository in a prompt, define the
 following styles in the `prompt_name_setup` function, where the syntax for
@ -361,7 +358,7 @@ zstyle ':prezto:module:git:info:context:subcontext' format 'string'
 ### Main Contexts
 | Name      | Format Code | Description
-| --------- | :---------: | ---------------------------------------------------
+| --------- | :---------: | ----------------------------------------------------
 | action    |     %s      | Special action name
 | ahead     |     %A      | Commits ahead of remote count
 | behind    |     %B      | Commits behind of remote count
@ -374,7 +371,7 @@ zstyle ':prezto:module:git:info:context:subcontext' format 'string'
 ### Concise Contexts
 | Name      | Format Code | Description
-| --------- | :---------: | ---------------------------------------------------
+| --------- | :---------: | ----------------------------------------------------
 | clean     |     %C      | Clean state
 | dirty     |     %D      | Dirty files count
 | indexed   |     %i      | Indexed files count
@ -390,7 +387,7 @@ zstyle ':prezto:module:git:info' verbose 'yes'
 ### Verbose Contexts
 | Name      | Format Code | Description
-| --------- | :---------: | ---------------------------------------------------
+| --------- | :---------: | ----------------------------------------------------
 | added     |     %a      | Added files count
 | clean     |     %C      | Clean state
 | deleted   |     %d      | Deleted files count
@ -435,22 +432,21 @@ Last, add `$git_info[prompt]` to `$PROMPT` and `$git_info[rprompt]` to
 `$RPROMPT` respectively and call `git-info` in the `prompt_name_preexec` hook
 function.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][6].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Colin Hebert](https://github.com/ColinHebert)
+- [Colin Hebert](https://github.com/ColinHebert)
-[1]: http://www.git-scm.com
+[1]: https://www.git-scm.com
 [2]: https://github.com/defunkt/hub
 [3]: https://www.github.com
-[4]: http://www.manpagez.com/man/8/gpt/
+[4]: https://www.manpagez.com/man/8/gpt/
-[5]: http://www.manpagez.com/man/1/gs/
+[5]: https://www.manpagez.com/man/1/gs/
 [6]: https://github.com/sorin-ionescu/prezto/issues
 [7]: https://github.com/sorin-ionescu/prezto/issues/219
-[8]: http://www.kernel.org/pub/software/scm/git/docs/git-log.html
+[8]: https://www.kernel.org/pub/software/scm/git/docs/git-log.html
 [9]: https://getgb.io/
 [10]: https://github.com/blog/985-git-io-github-url-shortener
-[11]: http://www.manpagez.com/man/1/gm/
+[11]: https://www.manpagez.com/man/1/gm/
--- a/modules/gnu-utility/README.md
+++ b/modules/gnu-utility/README.md
@ -1,9 +1,8 @@
-GNU Utility
+# GNU Utility
 ===========
 Provides for the interactive use of GNU utilities on BSD systems.
-Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.
+Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.,
 `ls` instead of `gls`, is not recommended since scripts that target other
 utilities will be broken.
@ -12,23 +11,21 @@ use.
 This module must be loaded **before** the *utility* module.
-Settings
+## Settings
 --------
 ### Prefix
-To use a different prefix, add the following to *zpreztorc*, and replace 'g' with
+To use a different prefix, add the following to *~/.zpreztorc*, and replace 'g'
-the desired prefix:
+with the desired prefix:
 ```sh
 zstyle ':prezto:module:gnu-utility' prefix 'g'
 ```
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/gpg/README.md
+++ b/modules/gpg/README.md
@ -1,13 +1,14 @@
-GPG
+# GPG
 ===
 Provides for an easier use of [GPG][1] by setting up [gpg-agent][2].
 ## Settings
 ### SSH
 To enable OpenSSH Agent protocol emulation, and make `gpg-agent` a drop-in
 replacement for `ssh-agent`, add the following line to
-*~/.gnupg/gpg-agent.conf*:
+*`~/.gnupg/gpg-agent.conf`*:
 ```conf
 enable-ssh-support
@ -16,13 +17,12 @@ enable-ssh-support
 When OpenSSH Agent protocol emulation is enabled, this module will load the SSH
 module for additional processing.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.gnupg.org
+[1]: https://www.gnupg.org
-[2]: http://linux.die.net/man/1/gpg-agent
+[2]: https://linux.die.net/man/1/gpg-agent
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/haskell/README.md
+++ b/modules/haskell/README.md
@ -1,10 +1,8 @@
-Haskell
+# Haskell
 =======
 Enables local Haskell package installation.
-Per-user Package Installation
+## Per-user Package Installation
 -----------------------------
 [Cabal][1], the Haskell package manager, can install packages into per user
 directories.
@ -17,12 +15,11 @@ documentation.
 Install packages into per user directories with `cabal install --user`.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sebastian Wiesner](https://github.com/lunaryorn)
+- [Sebastian Wiesner](https://github.com/lunaryorn)
-[1]: http://www.haskell.org/cabal/
+[1]: https://www.haskell.org/cabal/
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/helper/README.md
+++ b/modules/helper/README.md
@ -1,29 +1,26 @@
-Helper
+# Helper
 ======
 Provides helper functions for developing modules.
-Functions
+## Functions
 ---------
-  - `add-zsh-trap` adds a function name to a list to be called when a trap is
+- `add-zsh-trap` adds a function name to a list to be called when a trap is
-    triggered.
+  triggered.
-  - `is-autoloadable` checks if a file can be autoloaded by trying to load it
+- `is-autoloadable` checks if a file can be autoloaded by trying to load it in
-    in a subshell.
+  a subshell.
-  - `is-callable` checks if a name is a command, function, or alias.
+- `is-callable` checks if a name is a command, function, or alias.
-  - `is-true` checks a boolean variable for "true".
+- `is-true` checks a boolean variable for "true".
-  - `coalesce` prints the first non-empty string in the arguments array.
+- `coalesce` prints the first non-empty string in the arguments array.
-  - `is-darwin` checks if running on macOS Darwin.
+- `is-darwin` checks if running on macOS Darwin.
-  - `is-linux` checks if running on Linux.
+- `is-linux` checks if running on Linux.
-  - `is-bsd` checks if running on BSD.
+- `is-bsd` checks if running on BSD.
-  - `is-cygwin` checks if running on Cygwin (Windows).
+- `is-cygwin` checks if running on Cygwin (Windows).
-  - `is-termux` checks if running on Termux (Android).
+- `is-termux` checks if running on Termux (Android).
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/history-substring-search/README.md
+++ b/modules/history-substring-search/README.md
@ -1,28 +1,25 @@
-History Substring Search
+# History Substring Search
 ========================
-Integrates [zsh-history-substring-search][1] into Prezto, which implements
+Integrates [`zsh-history-substring-search`][1] into Prezto, which implements the
-the [Fish shell][2]'s history search feature, where the user can type in any
+[Fish shell][2]'s history search feature, where the user can type in any part of
-part of a previously entered command and press up and down to cycle through
+a previously entered command and press up and down to cycle through matching
-matching commands.
+commands.
 If this module is used in conjunction with the *syntax-highlighting* module,
 this module must be loaded **after** the *syntax-highlighting* module.
-Contributors
+## Contributors
 ------------
 New features and bug fixes should be submitted to the
-[zsh-history-substring-search][1] project according to its rules and
+[`zsh-history-substring-search`][1] project according to its rules and
 regulations. This module will be synchronized against it.
-Settings
+## Settings
 --------
 ### Case Sensitivity
 To enable case-sensitivity for this module only, add the following line to
-*zpreztorc*:
+*~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'
@ -34,38 +31,37 @@ If colors are enabled, *history-substring-search* will automatically highlight
 positive results.
 To enable highlighting for this module only, add the following line to
-*zpreztorc*:
+*~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:history-substring-search' color 'yes'
 ```
-To set the query found color, add the following line to *zpreztorc*:
+To set the query found color, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:history-substring-search:color' found ''
 ```
-To set the query not found color, add the following line to *zpreztorc*:
+To set the query not found color, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:history-substring-search:color' not-found ''
 ```
-To set the search globbing flags, add the following line to *zpreztorc*:
+To set the search globbing flags, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:history-substring-search' globbing-flags ''
 ```
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Suraj N. Kurapati](https://github.com/sunaku)
+- [Suraj N. Kurapati](https://github.com/sunaku)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/zsh-users/zsh-history-substring-search
-[2]: http://fishshell.com
+[2]: https://fishshell.com
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/history/README.md
+++ b/modules/history/README.md
@ -1,53 +1,48 @@
-History
+# History
 =======
 Sets [history][1] options and defines history aliases.
-**Note:** Default path of `HISTFILE` has changed from `${ZDOTDIR:-$HOME}/.zhistory`
+**Note:** Default path of `HISTFILE` has changed from *`${ZDOTDIR:-$HOME}/.zhistory`*
-to `${ZDOTDIR:-$HOME}/.zsh_history`. The file will be automatically renamed if
+to *`${ZDOTDIR:-$HOME}/.zsh_history`*. The file will be automatically renamed if
 possible (when the new one doesn't exist). Otherwise, if you want to preserve
-previous history, you will need to move them from `${ZDOTDIR:-$HOME}/.zhistory`
+previous history, you will need to move them from *`${ZDOTDIR:-$HOME}/.zhistory`*
-to `${ZDOTDIR:-$HOME}/.zsh_history`.
+to *`${ZDOTDIR:-$HOME}/.zsh_history`*.
-Alternately, you can set `HISTFILE` manually to `${ZDOTDIR:-$HOME}/.zhistory`.
+Alternately, you can set `HISTFILE` manually to *`${ZDOTDIR:-$HOME}/.zhistory`*.
-Options
+## Options
 -------
-  - `BANG_HIST` treats the **!** character specially during expansion.
+- `BANG_HIST` treats the **!** character specially during expansion.
-  - `EXTENDED_HISTORY` writes the history file in the *:start:elapsed;command* format.
+- `EXTENDED_HISTORY` writes the history file in the *:start:elapsed;command* format.
-  - `SHARE_HISTORY` shares history between all sessions. Note that
+- `SHARE_HISTORY` shares history between all sessions. Note that
-    `SHARE_HISTORY`, `INC_APPEND_HISTORY`, and `INC_APPEND_HISTORY_TIME` are
+  `SHARE_HISTORY`, `INC_APPEND_HISTORY`, and `INC_APPEND_HISTORY_TIME` are
-    mutually exclusive.
+  mutually exclusive.
-  - `HIST_EXPIRE_DUPS_FIRST` expires a duplicate event first when trimming history.
+- `HIST_EXPIRE_DUPS_FIRST` expires a duplicate event first when trimming history.
-  - `HIST_IGNORE_DUPS` does not record an event that was just recorded again.
+- `HIST_IGNORE_DUPS` does not record an event that was just recorded again.
-  - `HIST_IGNORE_ALL_DUPS` deletes an old recorded event if a new event is a duplicate.
+- `HIST_IGNORE_ALL_DUPS` deletes an old recorded event if a new event is a duplicate.
-  - `HIST_FIND_NO_DUPS` does not display a previously found event.
+- `HIST_FIND_NO_DUPS` does not display a previously found event.
-  - `HIST_IGNORE_SPACE` does not record an event starting with a space.
+- `HIST_IGNORE_SPACE` does not record an event starting with a space.
-  - `HIST_SAVE_NO_DUPS` does not write a duplicate event to the history file.
+- `HIST_SAVE_NO_DUPS` does not write a duplicate event to the history file.
-  - `HIST_VERIFY` does not execute immediately upon history expansion.
+- `HIST_VERIFY` does not execute immediately upon history expansion.
-  - `HIST_BEEP` beeps when accessing non-existent history.
+- `HIST_BEEP` beeps when accessing non-existent history.
-Variables
+## Variables
 ---------
-  - `HISTFILE` stores the path to the history file.
+- `HISTFILE` stores the path to the history file.
-  - `HISTSIZE` stores the maximum number of events to save in the internal history.
+- `HISTSIZE` stores the maximum number of events to save in the internal history.
-  - `SAVEHIST` stores the maximum number of events to save in the history file.
+- `SAVEHIST` stores the maximum number of events to save in the history file.
-Aliases
+## Aliases
 -------
-  - `history-stat` lists the ten most used commands
+- `history-stat` lists the ten most used commands
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Robby Russell](https://github.com/robbyrussell)
+- [Robby Russell](https://github.com/robbyrussell)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Indrajit Raychaudhuri](https://github.com/indrajitr)
+- [Indrajit Raychaudhuri](https://github.com/indrajitr)
-[1]: http://zsh.sourceforge.net/Guide/zshguide02.html#l16
+[1]: https://zsh.sourceforge.net/Guide/zshguide02.html#l16
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/homebrew/README.md
+++ b/modules/homebrew/README.md
@ -1,10 +1,8 @@
-Homebrew
+# Homebrew
 ========
 Defines Homebrew specific environment variables and aliases.
-Variables
+## Variables
 ---------
 Execute the following to list the environment variables loaded in the shell:
@ -12,35 +10,34 @@ Execute the following to list the environment variables loaded in the shell:
 brew shellenv
 ```
-Aliases
+## Aliases
 -------
-### Homebrew
+### Homebrew Core
-  - `brewc` cleans outdated brews and their cached archives.
+- `brewc` cleans outdated brews and their cached archives.
-  - `brewi` installs a formula.
+- `brewi` installs a formula.
-  - `brewL` lists installed formulae that are not dependencies of another installed formula.
+- `brewL` lists installed formulae that are not dependencies of another
-  - `brewl` lists installed formulae.
+  installed formula.
-  - `brewo` lists brews which have an update available.
+- `brewl` lists installed formulae.
-  - `brews` searches for a formula.
+- `brewo` lists brews which have an update available.
-  - `brewu` upgrades outdated formulae.
+- `brews` searches for a formula.
-  - `brewx` uninstalls a formula.
+- `brewu` upgrades outdated formulae.
 - `brewx` uninstalls a formula.
 ### Homebrew Cask
-  - `caski` installs a cask.
+- `caski` installs a cask.
-  - `caskl` lists installed casks.
+- `caskl` lists installed casks.
-  - `casko` lists casks which have an update available.
+- `casko` lists casks which have an update available.
-  - `casks` searches for a cask.
+- `casks` searches for a cask.
-  - `casku` upgrades outdated casks.
+- `casku` upgrades outdated casks.
-  - `caskx` uninstalls a cask.
+- `caskx` uninstalls a cask.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Griffin Yourick](https://github.com/tough-griff)
+- [Griffin Yourick](https://github.com/tough-griff)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/macports/README.md
+++ b/modules/macports/README.md
@ -1,25 +1,22 @@
-MacPorts
+# MacPorts
 ========
 Defines MacPorts aliases and adds MacPorts directories to path variables.
-Aliases
+## Aliases
 -------
-  - `portc` cleans the files used to build ports.
+- `portc` cleans the files used to build ports.
-  - `porti` installs a port.
+- `porti` installs a port.
-  - `ports` searches for a port.
+- `ports` searches for a port.
-  - `portu` upgrades a port.
+- `portu` upgrades a port.
-  - `portU` upgrades MacPorts, the ports collection, and outdated ports.
+- `portU` upgrades MacPorts, the ports collection, and outdated ports.
-  - `portx` uninstalls a port.
+- `portx` uninstalls a port.
-  - `portX` uninstalls inactive ports.
+- `portX` uninstalls inactive ports.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Matt Cable](https://github.com/curiousstranger)
+- [Matt Cable](https://github.com/curiousstranger)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/node/README.md
+++ b/modules/node/README.md
@ -1,38 +1,33 @@
-Node.js
+# Node.js
 =======
 Provides utility functions for [Node.js][1], loads the Node Version Manager, and
-enables [npm][2] completion.
+enables [*npm*][2] completion.
-nvm
+## nvm
 ---
-[nvm][5] allows for managing multiple, isolated Node.js installations in the
+[*nvm*][5] allows for managing multiple, isolated Node.js installations in the
 home directory.
 This will be loaded automatically if nvm is installed in `$NVM_DIR`,
-`~/.nvm`, or nvm is installed with homebrew.
+*~/.nvm*, or nvm is installed with homebrew.
-nodenv
+## nodenv
 ------
-[nodenv][6] does one thing well. nodenv is concerned solely with switching
+[*nodenv*][6] does one thing well - it is concerned solely with switching
-Node versions. It's simple and predictable, Just Works, and is rock solid in
+Node versions. It is simple and predictable, Just Works, and is rock solid in
-production. nodenv is forked from the popular [rbenv][7].
+production. nodenv is forked from the popular [*rbenv*][7].
 This will be loaded automatically if nodenv is installed in `$NODENV_ROOT`,
-`~/.nodenv`, or `nodenv` is on the path.
+*~/.nodenv*, or `nodenv` is on the path.
-Functions
+## Functions
 ---------
-  - `node-doc` opens the Node.js online [API documentation][3] in the default
+- `node-doc` opens the Node.js online [API documentation][3] in the default
-    browser.
+  browser.
-  - `node-info` exposes information about the Node.js environment via the
+- `node-info` exposes information about the Node.js environment via the
-    `$node_info` associative array.
+  `$node_info` associative array.
-Theming
+## Theming
 -------
 To display the version number of the current Node.js version, define the
 following style inside the `prompt_name_setup` function.
@ -45,13 +40,12 @@ zstyle ':prezto:module:node:info:version' format 'version:%v'
 Then add `$node_info[version]` to either `$PROMPT` or `$RPROMPT` and call
 `node-info` in `prompt_name_preexec` hook function.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][4].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Zeh Rizzatti](https://github.com/zehrizzatti)
+- [Zeh Rizzatti](https://github.com/zehrizzatti)
 [1]: http://nodejs.org
 [2]: http://npmjs.org
--- a/modules/ocaml/README.md
+++ b/modules/ocaml/README.md
@ -1,10 +1,8 @@
-OCaml
+# OCaml
 =====
 Initializes [OCaml][1] package management.
-OPAM
+## OPAM
 ----
 [OPAM][2] is a package manager for OCaml.
@ -15,13 +13,12 @@ relevant path and OCaml variables.
 Install packages to your local package directory with `opam install`.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sebastian Wiesner](https://github.com/lunaryorn)
+- [Sebastian Wiesner](https://github.com/lunaryorn)
-[1]: http://ocaml.org/
+[1]: https://ocaml.org/
 [2]: http://opam.ocamlpro.com/
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/osx/README.md
+++ b/modules/osx/README.md
@ -1,50 +1,44 @@
-OSX
+# OSX
 ===
 Defines [macOS][1] aliases and functions.
-Settings
+## Settings
 --------
 ### Dash Keyword
-To change the keyword used by `mand` to open man pages in [_Dash.app_][2] from
+To change the keyword used by `mand` to open man pages in [*Dash.app*][2] from
-its default value of 'manpages', add the following line in *zpreztorc* and
+its default value of 'manpages', add the following line in *~/.zpreztorc* and
-replace the **keyword** with the one configured in [_Dash.app_][2].
+replace the **keyword** with the one configured in [*Dash.app*][2].
 ```sh
 zstyle ':prezto:module:osx:man' dash-keyword 'keyword'
 ```
-Aliases
+## Aliases
 -------
-  - `cdf` changes the current working director to the current _Finder_
+- `cdf` changes the current working director to the current *Finder* directory.
-    directory.
+- `pushdf` pushes the current working directory onto the directory queue and
-  - `pushdf` pushes the current working directory onto the directory queue and
+  changes the current working director to the current *Finder* directory.
    changes the current working director to the current _Finder_ directory.
-Functions
+## Functions
 ---------
-  - `mand` opens _man_ pages in [_Dash.app_][2].
+- `mand` opens _man_ pages in [*Dash.app*][2].
-  - `manp` opens _man_ pages in _Preview.app_.
+- `manp` opens _man_ pages in *Preview.app*.
-  - `pfd` prints the current _Finder_ directory.
+- `pfd` prints the current *Finder* directory.
-  - `pfs` prints the current _Finder_ selection.
+- `pfs` prints the current *Finder* selection.
-  - `tab` creates a new tab (works in both _Terminal_ and [_iTerm_][3]).
+- `tab` creates a new tab (works in both _Terminal_ and [*iTerm.app*][3]).
-  - `ql` previews files in Quick Look.
+- `ql` previews files in Quick Look.
-  - `osx-rm-dir-metadata` deletes .DS\_Store, \_\_MACOSX cruft.
+- `osx-rm-dir-metadata` deletes *.DS_Store*, *__MACOSX* cruft.
-  - `osx-ls-download-history` displays the macOS download history.
+- `osx-ls-download-history` displays the macOS download history.
-  - `osx-rm-download-history` deletes the macOS download history.
+- `osx-rm-download-history` deletes the macOS download history.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][4].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.apple.com/macosx/
+[1]: https://www.apple.com/macos/
-[2]: http://kapeli.com/dash
+[2]: https://kapeli.com/dash
-[3]: http://www.iterm2.com/
+[3]: https://www.iterm2.com/
 [4]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/pacman/README.md
+++ b/modules/pacman/README.md
@ -1,11 +1,9 @@
-Pacman
+# Pacman
 ======
 Provides aliases and functions for the [Pacman][1] package manager and
 frontends.
-Settings
+## Settings
 --------
 It is possible to use a Pacman frontend with the pacman aliases provided by this
 package as long as that frontend supports the same command line options (The
@ -17,53 +15,50 @@ supported by Archlinux. It is currently recommended to manually build AUR
 packages using the [provided instructions][3]. The [aurutils][4] project has a
 set of small utilities to make this easier.
-To enable a Pacman frontend, add the following line to *zpreztorc*, substituting
+To enable a Pacman frontend, add the following line to *~/.zpreztorc*,
-`pacman_frontend` with the name of the frontent:
+substituting *pacman_frontend* with the name of the frontend:
 ```sh
 zstyle ':prezto:module:pacman' frontend 'pacman_frontend'
 ```
-Aliases
+## Aliases
 -------
 ### Pacman
-  - `pac` is short for `pacman`.
+- `pac` is short for `pacman`.
-  - `paci` installs packages from repositories.
+- `paci` installs packages from repositories.
-  - `pacI` installs packages from files.
+- `pacI` installs packages from files.
-  - `pacx` removes packages and unneeded dependencies.
+- `pacx` removes packages and unneeded dependencies.
-  - `pacX` removes packages, their configuration, and unneeded dependencies.
+- `pacX` removes packages, their configuration, and unneeded dependencies.
-  - `pacq` displays information about a package from the repositories.
+- `pacq` displays information about a package from the repositories.
-  - `pacQ` displays information about a package from the local database.
+- `pacQ` displays information about a package from the local database.
-  - `pacs` searches for packages in the repositories.
+- `pacs` searches for packages in the repositories.
-  - `pacS` searches for packages in the local database.
+- `pacS` searches for packages in the local database.
-  - `pacu` synchronizes the local package and Arch Build System (requires `abs`)
+- `pacu` synchronizes the local package and Arch Build System (requires `abs`)
-    databases against the repositories.
+  databases against the repositories.
-  - `pacU` synchronizes the local package database against the repositories then
+- `pacU` synchronizes the local package database against the repositories then
-    upgrades outdated packages.
+  upgrades outdated packages.
-  - `pacman-list-orphans` lists orphan packages.
+- `pacman-list-orphans` lists orphan packages.
-  - `pacman-remove-orphans` removes orphan packages.
+- `pacman-remove-orphans` removes orphan packages.
 ### Frontends
-Functions
+## Functions
 ---------
-  - `aurget` clone an aur package
+- `aurget` clone an aur package.
-  - `pacman-list-explicit` lists explicitly installed pacman packages.
+- `pacman-list-explicit` lists explicitly installed pacman packages.
-  - `pacman-list-disowned` lists pacman disowned files.
+- `pacman-list-disowned` lists pacman disowned files.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][5].*
-  - [Benjamin Boudreau](https://github.com/dreur)
+- [Benjamin Boudreau](https://github.com/dreur)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.archlinux.org/pacman/
+[1]: https://www.archlinux.org/pacman/
-[2]: https://wiki.archlinux.org/index.php/AUR_helpers#Comparison_table
+[2]: https://wiki.archlinux.org/title/AUR_helpers#Comparison_tables
-[3]: https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages
+[3]: https://wiki.archlinux.org/title/Arch_User_Repository#Installing_and_upgrading_packages
 [4]: https://github.com/AladW/aurutils
 [5]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/perl/README.md
+++ b/modules/perl/README.md
@ -1,18 +1,16 @@
-Perl
+# Perl
 ====
 Enables local [Perl][1] module installation on macOS and defines aliases.
-Local Module Installation
+## Local Module Installation
 -------------------------
 Perl versions older than 5.14 do not support the local installation of Perl
 modules natively. This module allows for local installation of Perl modules on
-macOS in *~/Library/Perl/5.12* by altering the environment.
+macOS in *`~/Library/Perl/5.12`* by altering the environment.
 ### Usage
-For Perl versions older than 5.14, install *local::lib*.
+For Perl versions older than 5.14, install *`local::lib`*.
 ```console
 curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
@ -28,67 +26,62 @@ Install *cpanminus*:
 curl -L http://cpanmin.us | perl - --self-upgrade
 ```
-Perlbrew
+## Perlbrew
 --------
 An alternative to the above is to use [Perlbrew][2], which allows for the
 management of multiple, isolated Perl installations in the home directory.
-plenv
+## plenv
 -----
-Yet another alternative is [plenv][3]. This is inspired from rbenv and enables
+Yet another alternative is [*plenv*][3]. This is inspired from *rbenv* and
-switching between multiple binary installations.
+enables switching between multiple binary installations.
-The subcommands of plenv is similar with rbenv.
+The subcommands of *plenv* is similar with *rbenv*.
-Aliases
+## Aliases
 -------
 ### General
-  - `pl` is short for `perl`.
+- `pl` is short for `perl`.
-  - `pld` looks up Perl documentation (`perldoc`).
+- `pld` looks up Perl documentation (`perldoc`).
-  - `ple` executes a one line program in a loop (`perl -wlne`).
+- `ple` executes a one line program in a loop (`perl -wlne`).
-
+
-### Perlbrew
+### Perlbrew (plb)
-
+
-  - `plb` manages Perl environments.
+- `plb` manages Perl environments.
-  - `plba` lists available Perl versions.
+- `plba` lists available Perl versions.
-  - `plbi` installs a Perl version.
+- `plbi` installs a Perl version.
-  - `plbl` lists installed Perl versions.
+- `plbl` lists installed Perl versions.
-  - `plbo` temporarily turns off Perlbrew.
+- `plbo` temporarily turns off Perlbrew.
-  - `plbO` turns off Perlbrew.
+- `plbO` turns off Perlbrew.
-  - `plbs` switches to a Perl version.
+- `plbs` switches to a Perl version.
-  - `plbu` uninstalls a Perl version.
+- `plbu` uninstalls a Perl version.
-  - `plbx` temporarily sets the Perl version to use.
+- `plbx` temporarily sets the Perl version to use.
-
+
-### plenv
+### plenv (plv)
-
+
-  - `plv` manages Perl environments.
+- `plv` manages Perl environments.
-  - `plvc` List all available plenv commands.
+- `plvc` List all available plenv commands.
-  - `plvl` Set or show the local application-specific Perl version.
+- `plvl` Set or show the local application-specific Perl version.
-  - `plvg` Set or show the global Perl version.
+- `plvg` Set or show the global Perl version.
-  - `plvs` Set or show the shell-specific Perl version.
+- `plvs` Set or show the shell-specific Perl version.
-  - `plvi` Install a Perl version using the perl-build plugin.
+- `plvi` Install a Perl version using the perl-build plugin.
-  - `plvu` Uninstall a specific Perl version.
+- `plvu` Uninstall a specific Perl version.
-  - `plvr` Rehash plenv shims (run this after installing executables).
+- `plvr` Rehash plenv shims (run this after installing executables).
-  - `plvv` Show the current Perl version and its origin.
+- `plvv` Show the current Perl version and its origin.
-  - `plvV` List all Perl versions available to plenv.
+- `plvV` List all Perl versions available to plenv.
-  - `plvw` Display the full path to an executable.
+- `plvw` Display the full path to an executable.
-  - `plvW` List all Perl versions that contain the given executable.
+- `plvW` List all Perl versions that contain the given executable.
-  - `plvm` List cpan modules in current perl.
+- `plvm` List cpan modules in current perl.
-  - `plvM` Migrate cpan modules from other version.
+- `plvM` Migrate cpan modules from other version.
-  - `plvI` Install cpanm.
+- `plvI` Install cpanm.
-
+
-Functions
+## Functions
---------
+
-
+- `perl-info` exposes information about the Perl environment via the
-  - `perl-info` exposes information about the Perl environment via the
+  `$perl_info` associative array.
-    `$perl_info` associative array.
+
-
+## Theming
 Theming
 -------
 To display the name of the current Perl version in a prompt, define the
 following style in the `prompt_name_setup` function.
@ -101,14 +94,13 @@ zstyle ':prezto:module:perl:info:version' format 'version:%v'
 Then add `$perl_info[version]` to `$PROMPT` or `$RPROMPT` and call
 `perl-info` in the `prompt_name_precmd` hook function.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][4].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.perl.org
+[1]: https://www.perl.org
-[2]: http://perlbrew.pl
+[2]: https://perlbrew.pl
 [3]: https://github.com/tokuhirom/plenv
 [4]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/prompt/README.md
+++ b/modules/prompt/README.md
@ -1,16 +1,14 @@
-Prompt
+# Prompt
 ======
 Loads prompt [themes][1].
-Settings
+## Settings
 --------
 ### Prompt Theme
-To select a prompt theme, add the following to *zpreztorc*, and replace **name**
+To select a prompt theme, add the following to *~/.zpreztorc*, and replace
-with the name of the theme you wish to load. Setting it to **random** will load
+**name** with the name of the theme you wish to load. Setting it to **random**
-a random theme.
+will load a random theme.
 ```sh
 zstyle ':prezto:module:prompt' theme 'name'
@ -19,8 +17,8 @@ zstyle ':prezto:module:prompt' theme 'name'
 ### Prompt Display Length
 To change working directory prompt display length from 'short', set the
-following to 'long' (without `~` expansion) or 'full' (with `~` expansion)
+following to 'long' (without `~` expansion) or 'full' (with `~` expansion) in
-in *zpreztorc*.
+*~/.zpreztorc*.
 ```sh
 zstyle ':prezto:module:prompt' pwd-length 'short'
@ -35,8 +33,7 @@ this can be disabled with the following snippet.
 zstyle ':prezto:module:prompt' show-return-val 'no'
 ```
-Theming
+## Theming
 -------
 A prompt theme is an autoloadable function file with a special name,
 `prompt_name_setup`, placed anywhere in `$fpath`, but for the purpose of this
@ -46,11 +43,11 @@ directory.
 ### Required Variables
 To ensure that your function works with the editor-info module you'll need to
-set the following variable:
+set the following variable in *~/.zpreztorc*:
-```
+```sh
-  # Tell prezto we can manage this prompt
+# Tell prezto we can manage this prompt
-  zstyle ':prezto:module:prompt' managed 'yes'
+zstyle ':prezto:module:prompt' managed 'yes'
 ```
 This is to ensure compatibility with outside prompts, while allowing prezto
@ -134,7 +131,8 @@ When calling functions to get information to display in a prompt, do not assume
 that all the dependencies have been loaded. Always check for the availability of
 a function before you calling it.
-**Do not register hook functions. They will be registered by the `prompt` function.**
+**Do not register hook functions. They will be automatically registered by the
 `prompt` function.**
 The most basic example of this function can be seen below.
@ -146,10 +144,9 @@ function prompt_name_precmd {
 }
 ```
-Troubleshooting
+## Troubleshooting
 ---------------
-### Fonts aren't displaying properly.
+### Fonts aren't displaying properly
 On most systems, themes which use special characters need to have a patched font
 installed and configured properly.
@ -157,16 +154,14 @@ installed and configured properly.
 Powerline provides some information on [terminal support][4] and [how to install
 patched fonts][5] which should fix most font issues.
-
+## Authors
 Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
+[1]: https://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
-[2]: http://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
+[2]: https://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
 [3]: https://github.com/sorin-ionescu/prezto/issues
-[4]: http://powerline.readthedocs.io/en/master/usage.html#terminal-emulator-requirements
+[4]: https://powerline.readthedocs.io/en/master/usage.html#terminal-emulator-requirements
-[5]: http://powerline.readthedocs.io/en/latest/installation.html#fonts-installation
+[5]: https://powerline.readthedocs.io/en/latest/installation.html#fonts-installation
--- a/modules/python/README.md
+++ b/modules/python/README.md
@ -1,20 +1,18 @@
-Python
+# Python
 ======
 Enables local Python and local Python package installation.
-Settings
+## Settings
 --------
-This module supports virtual environments from conda and virtualenvwrapper. By
+This module supports virtual environments from conda and
-default, only virtualenvwrapper is enabled. To disable virtualenvwrapper, add
+[*virtualenvwrapper*][2]. By default, only *virtualenvwrapper* is enabled. To
-the following to *zpreztorc*.
+disable *virtualenvwrapper*, add the following to *~/.zpreztorc*.
 ```sh
 zstyle ':prezto:module:python' skip-virtualenvwrapper-init 'on'
 ```
-Conda support is enabled by adding the following to *zpreztorc*.
+Conda support is enabled by adding the following to *~/.zpreztorc*.
 ```sh
 zstyle ':prezto:module:python' conda-init 'on'
@ -22,24 +20,22 @@ zstyle ':prezto:module:python' conda-init 'on'
 Caution: using conda and virtualenvwrapper at the same time may cause conflicts.
-Local Python Installation
+## Local Python Installation
 -------------------------
-[pyenv][4] builds and installs multiple Python versions locally in the home
+[*pyenv*][4] builds and installs multiple Python versions locally in the home
 directory.
-This module prepends the pyenv directory to the path variable to enable the
+This module prepends the *pyenv* directory to the path variable to enable the
 execution of `pyenv`.
 ### Usage
-Install Python versions with `pyenv install` into `~/.pyenv/versions`.
+Install Python versions with `pyenv install` into *~/.pyenv/versions*.
 This will be loaded automatically if pyenv is installed to `$PYENV_ROOT`,
-`~/.pyenv`, or if the `pyenv` command is on the path.
+*~/.pyenv*, or if the `pyenv` command is on the path.
-Local Package Installation
+## Local Package Installation
 --------------------------
 Since version 2.6, Python supports per user package installation, as defined in
 [PEP 370][1].
@ -52,10 +48,9 @@ documentation.
 Install packages into the per user site directory with `pip install --user`.
-virtualenvwrapper
+## virtualenvwrapper
 -----------------
-[`virtualenvwrapper`][2] is a frontend to the popular [`virtualenv`][3] utility.
+[*virtualenvwrapper*][2] is a frontend to the popular [*virtualenv*][3] utility.
 `virtualenv` creates isolated Python environments and `virtualenvwrapper`
 provides convenient shell functions to create, switch, and manage them.
@ -64,7 +59,7 @@ provides convenient shell functions to create, switch, and manage them.
 Install `virtualenvwrapper`.
-Virtual environments are stored in `~/.virtualenvs`.
+Virtual environments are stored in *~/.virtualenvs*.
 There are configuration variables that have to be set to enable certain features.
 If you wish to use these features, export the variables in [`zshenv`][6].
@ -119,27 +114,26 @@ zstyle ':prezto:module:python:virtualenv' auto-switch 'yes'
 zstyle ':prezto:module:python:virtualenv' initialize 'no'
 ```
-Aliases
+## Aliases
 -------
-  - `py` is short for `python`.
+- `py` is short for `python`.
-  - `py2` is short for `python2`.
+- `py2` is short for `python2`.
-  - `py3` is short for `python3`.
+- `py3` is short for `python3`.
-Functions
+## Functions
 ---------
-  - `python-info` exposes information about the Python environment via the
+- `python-info` exposes information about the Python environment via the
-    `$python_info` associative array.
+  `$python_info` associative array.
-Theming
+## Theming
 -------
-To display the name of the current virtual enviroment in a prompt, define the
+To display the name of the current virtual environment in a prompt, define the
 following style in the `prompt_name_setup` function.
-    # %v - virtualenv name.
+```sh
-    zstyle ':prezto:module:python:info:virtualenv' format 'virtualenv:%v'
+# %v - virtualenv name.
 zstyle ':prezto:module:python:info:virtualenv' format 'virtualenv:%v'
 ```
 Then add `$python_info[virtualenv]` to `$PROMPT` or `$RPROMPT` and call
 `python-info` in the `prompt_name_preexec` hook function.
@ -148,17 +142,16 @@ Similarly, you can use `:prezto:module:python:info:version:format` with `%v` for
 the version and add `$python_info[version]` to your prompt for the current
 python version/
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][5].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Sebastian Wiesner](https://github.com/lunaryorn)
+- [Sebastian Wiesner](https://github.com/lunaryorn)
-[1]: http://www.python.org/dev/peps/pep-0370/
+[1]: https://www.python.org/dev/peps/pep-0370/
-[2]: http://www.doughellmann.com/projects/virtualenvwrapper/
+[2]: https://www.doughellmann.com/projects/virtualenvwrapper/
-[3]: http://pypi.python.org/pypi/virtualenv
+[3]: https://pypi.org/project/virtualenv/
 [4]: https://github.com/yyuu/pyenv
 [5]: https://github.com/sorin-ionescu/prezto/issues
 [6]: https://github.com/sorin-ionescu/prezto/blob/master/runcoms/zshenv
--- a/modules/rails/README.md
+++ b/modules/rails/README.md
@ -1,34 +1,31 @@
-Ruby on Rails
+# Ruby on Rails
 =============
 Defines [Ruby on Rails][1] aliases.
-Aliases
+## Aliases
 -------
-  - `ror` is short for `rails`.
+- `ror` is short for `rails`.
-  - `rorc` starts the Rails console.
+- `rorc` starts the Rails console.
-  - `rordc` starts the Rails console connected to the database.
+- `rordc` starts the Rails console connected to the database.
-  - `rordm` migrates the database.
+- `rordm` migrates the database.
-  - `rordM` migrates the database and recreates the test database.
+- `rordM` migrates the database and recreates the test database.
-  - `rordr` rolls the database schema back to the previous version.
+- `rordr` rolls the database schema back to the previous version.
-  - `rorg` generates new code.
+- `rorg` generates new code.
-  - `rorl` displays the log.
+- `rorl` displays the log.
-  - `rorlc` truncates logs to zero bytes.
+- `rorlc` truncates logs to zero bytes.
-  - `rorp` installs a plugin.
+- `rorp` installs a plugin.
-  - `rorr` runs code in the application environment.
+- `rorr` runs code in the application environment.
-  - `rors` starts the Rails server.
+- `rors` starts the Rails server.
-  - `rorsd` starts the Rails server with the debugger.
+- `rorsd` starts the Rails server with the debugger.
-  - `rorx` destroys newly generated code.
+- `rorx` destroys newly generated code.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Robby Russell](https://github.com/robbyrussell)
+- [Robby Russell](https://github.com/robbyrussell)
-  - [Jake Bell](https://github.com/theunraveler)
+- [Jake Bell](https://github.com/theunraveler)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://rubyonrails.org
+[1]: https://rubyonrails.org
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/rsync/README.md
+++ b/modules/rsync/README.md
@ -1,26 +1,23 @@
-Rsync
+# Rsync
 =====
 Defines [rsync][1] aliases.
 macOS users are encouraged to use *rsync* from [Homebrew][2] or [MacPorts][3],
 which has additional enhancements including patches from [Bombich][4].
-Aliases
+## Aliases
 -------
-  - `rsync-copy` copies files and directories from *source* to *destination*.
+- `rsync-copy` copies files and directories from *source* to *destination*.
-  - `rsync-move` moves files and directories from *source* to *destination*.
+- `rsync-move` moves files and directories from *source* to *destination*.
-  - `rsync-update` updates files and directories on *destination*.
+- `rsync-update` updates files and directories on *destination*.
-  - `rsync-synchronize` synchronizes files and directories between *source* and
+- `rsync-synchronize` synchronizes files and directories between *source* and
-    *destination*.
+  *destination*.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][5].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://rsync.samba.org
 [2]: https://github.com/Homebrew/homebrew-core
--- a/modules/ruby/README.md
+++ b/modules/ruby/README.md
@ -1,21 +1,18 @@
-Ruby
+# Ruby
 ====
 Configures [Ruby][1] local gem installation, loads version managers, and defines
 aliases.
-Local Gem Installation
+## Local Gem Installation
 ----------------------
 When a Ruby version manager is not detected, local gems are installed in
-`~/.gems`; otherwise, they are installed according to the manager.
+*~/.gems*; otherwise, they are installed according to the manager.
-RVM
+## rvm
 ---
-An alternative to the above is to use [The Ruby Version Manager (RVM)][2], which
+An alternative to the above is to use [The Ruby Version Manager (*rvm*)][2],
-allows for managing multiple, isolated Ruby installations and gem sets in the
+which allows for managing multiple, isolated Ruby installations and gem sets in
-home directory.
+the home directory.
 Since RVM is loaded into the shell and is known to override shell commands, it
 may conflict with shell scripts.
@ -23,93 +20,87 @@ may conflict with shell scripts.
 Load this module as late as possible when using RVM since RVM will complain if
 it is not first in `$PATH`.
-rbenv
+## rbenv
 -----
-An alternative RVM is to use [rbenv][3], which allows for switching between
+An alternative RVM is to use [*rbenv*][3], which allows for switching between
 multiple, isolated Ruby installations in the home directory.
 While it is not as feature rich as RVM, it is not loaded into the shell and is
 not known to cause conflicts with shell scripts.
-This will be loaded automatically if rbenv is installed to `$RBENV_ROOT`,
+This will be loaded automatically if *rbenv* is installed to `$RBENV_ROOT`,
-`~/.rbenv`, or if the `rbenv` command is on the path.
+*~/.rbenv*, or if the `rbenv` command is on the path.
-chruby
+## chruby
 ------
-Yet another alternative is [chruby][4], which is simpler than both RVM and
+Yet another alternative is [*chruby*][4], which is simpler than both *rvm* and
-rbenv.
+*rbenv*.
 ### Settings
 #### Auto-Switch
 To enable auto switching the Ruby version on directory change based on the
-`.ruby-version` file, add the following line to [`zpreztorc`][5]:
+`.ruby-version` file, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:ruby:chruby' auto-switch 'yes'
 ```
-Bundler
+## Bundler
 -------
 Manage gems that are not meant to be used as commands, such as application
-dependencies, with [Bundler][6].
+dependencies, with [Bundler][5].
-Aliases
+## Aliases
 -------
 ### General
-  - `rb` is short for `ruby`.
+- `rb` is short for `ruby`.
 ### Bundler
-  - `rbb` manages ruby dependencies (`bundle`).
+- `rbb` manages ruby dependencies (`bundle`).
-  - `rbbc` cleans up unused gems in your bundler directory.
+- `rbbc` cleans up unused gems in your bundler directory.
-  - `rbbe` executes a script in the context of the current bundle.
+- `rbbe` executes a script in the context of the current bundle.
-  - `rbbi` installs the gems specified in the `Gemfile` in `vendor/bundle`.
+- `rbbi` installs the gems specified in the `Gemfile` in `vendor/bundle`.
-  - `rbbI` installs the following:
+- `rbbI` installs the following:
-    - gems specified in the `Gemfile` in `vendor/bundle`.
+  - gems specified in the `Gemfile` in `vendor/bundle`.
-    - packages the gems into `vendor/cache`.
+  - packages the gems into `vendor/cache`.
-    - appends bundler directories to  `.gitignore`.
+  - appends bundler directories to  `.gitignore`.
-  - `rbbl` lists all gems in the current bundle.
+- `rbbl` lists all gems in the current bundle.
-  - `rbbo` opens an installed gem in the editor.
+- `rbbo` opens an installed gem in the editor.
-  - `rbbp` packages gem files into `vendor/cache`.
+- `rbbp` packages gem files into `vendor/cache`.
-  - `rbbu` updates gems to their latest version.
+- `rbbu` updates gems to their latest version.
-
+
-Functions
+## Functions
---------
+
-
+- `ruby-app-root` displays the path to the Ruby application root directory.
-  - `ruby-app-root` displays the path to the Ruby application root directory.
+- `ruby-info` exposes information about the Ruby environment via the
-  - `ruby-info` exposes information about the Ruby environment via the
+  `$ruby_info` associative array.
-    `$ruby_info` associative array.
+
-
+## Theming
 Theming
 -------
 To display the name of the current Ruby version in a prompt, define the
 following style in the `prompt_name_setup` function.
-    # %v - ruby version.
+```sh
-    zstyle ':prezto:module:ruby:info:version' format 'version:%v'
+# %v - ruby version.
 zstyle ':prezto:module:ruby:info:version' format 'version:%v'
 ```
 Then add `$ruby_info[version]` to `$PROMPT` or `$RPROMPT` and call
 `ruby-info` in the `prompt_name_preexec` hook function.
-Authors
+## Authors
 -------
-*The authors of this module should be contacted via the [issue tracker][7].*
+*The authors of this module should be contacted via the [issue tracker][6].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.ruby-lang.org
+[1]: https://www.ruby-lang.org
 [2]: https://rvm.io
 [3]: https://github.com/sstephenson/rbenv
 [4]: https://github.com/postmodern/chruby
-[5]: https://github.com/sorin-ionescu/prezto/blob/master/runcoms/zpreztorc
+[5]: https://gembundler.com
-[6]: http://gembundler.com
+[6]: https://github.com/sorin-ionescu/prezto/issues
 [7]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/screen/README.md
+++ b/modules/screen/README.md
@ -1,44 +1,40 @@
-GNU Screen
+# GNU Screen
 ==========
 Defines [GNU Screen][1] aliases and provides for auto launching it at start-up.
-Settings
+## Settings
 --------
 ### Auto-Start
 Starts a GNU Screen session automatically when Zsh is launched.
-To enable this feature when launching Zsh in a local terminal, add the
+To enable this feature when launching Zsh in a local terminal, add the following
-following line to *zpreztorc*:
+line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:screen:auto-start' local 'yes'
 ```
-To enable this feature when launching Zsh in a SSH connection, add the
+To enable this feature when launching Zsh in a SSH connection, add the following
-following line to *zpreztorc*:
+line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:screen:auto-start' remote 'yes'
 ```
-Aliases
+## Aliases
 -------
-  - `scr` is short for `screen`.
+- `scr` is short for `screen`.
-  - `scrl` lists sessions/socket directory.
+- `scrl` lists sessions/socket directory.
-  - `scrn` starts a new session.
+- `scrn` starts a new session.
-  - `scrr` attaches to a session if one exists or start a new one.
+- `scrr` attaches to a session if one exists or start a new one.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Georges Discry](https://github.com/gdiscry)
+- [Georges Discry](https://github.com/gdiscry)
-[1]: http://www.gnu.org/software/screen/
+[1]: https://www.gnu.org/software/screen/
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/spectrum/README.md
+++ b/modules/spectrum/README.md
@ -1,16 +1,14 @@
-Spectrum
+# Spectrum
 ========
 Provides for easier use of 256 colors and effects.
 To learn more about text formatting, read [A Guide to 256 Color Codes][1].
-Variables
+## Variables
 ---------
-  - `BG` provides background colors.
+- `BG` provides background colors.
-  - `FG` provides foreground colors.
+- `FG` provides foreground colors.
-  - `FX` provides effects.
+- `FX` provides effects.
 ### Background and Foreground
@ -79,13 +77,12 @@ Though there are many effects, most terminals support at least bold formatting.
 Use `$BG[none]`, `$FG[none]`, or `$FX[none]` to turn off formatting.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [P.C. Shyamshankar](https://github.com/sykora)
+- [P.C. Shyamshankar](https://github.com/sykora)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: http://lucentbeing.com/writing/archives/a-guide-to-256-color-codes/
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/ssh/README.md
+++ b/modules/ssh/README.md
@ -1,26 +1,23 @@
-SSH
+# SSH
 ===
-Provides for an easier use of [SSH][1] by setting up [ssh-agent][2].
+Provides for an easier use of [SSH][1] by setting up [*ssh-agent*][2].
-Settings
+## Settings
 --------
 ### Identities
-To load multiple identities, add the following line to *zpreztorc*:
+To load multiple identities, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:ssh:load' identities 'id_rsa' 'id_dsa' 'id_github'
 ```
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+[Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.openssh.com
+[1]: https://www.openssh.com
-[2]: http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
+[2]: https://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/syntax-highlighting/README.md
+++ b/modules/syntax-highlighting/README.md
@ -1,5 +1,4 @@
-Syntax Highlighting
+# Syntax Highlighting
 ===================
 Integrates [zsh-syntax-highlighting][1] into Prezto.
@ -9,23 +8,21 @@ Additionally, if this module is used in conjunction with the
 *history-substring-search* module, this module must be loaded **before** the
 *history-substring-search* module.
-To elaborate: The relative order of loading the modules would be 
+To elaborate: The relative order of loading the modules would be
 'syntax-highlighting', 'history-substring-search' and 'prompt'.
-Contributors
+## Contributors
 ------------
 New features and bug fixes should be submitted to the
 [zsh-syntax-highlighting][1] project according to its rules and regulations.
 This module will be synchronized against it.
-Settings
+## Settings
 --------
 ### Highlighting
 To enable highlighting for this module only, add the following line to
-*zpreztorc*:
+*~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:syntax-highlighting' color 'yes'
@ -36,7 +33,7 @@ zstyle ':prezto:module:syntax-highlighting' color 'yes'
 Syntax highlighting is accomplished by pluggable [highlighters][2]. This module
 only enables the *main* highlighter by default.
-To enable all highlighters, add the following to *zpreztorc*:
+To enable all highlighters, add the following to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:syntax-highlighting' highlighters \
@ -53,7 +50,7 @@ zstyle ':prezto:module:syntax-highlighting' highlighters \
 Each syntax highlighter defines styles used to highlight tokens.
 To highlight, for example, builtins, commands, and functions in blue instead of
-green, add the following to *zpreztorc*:
+green, add the following to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:syntax-highlighting' styles \
@ -62,12 +59,11 @@ zstyle ':prezto:module:syntax-highlighting' styles \
  'function' 'bg=blue'
 ```
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][3].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/zsh-users/zsh-syntax-highlighting
 [2]: https://github.com/zsh-users/zsh-syntax-highlighting/tree/master/highlighters
--- a/modules/terminal/README.md
+++ b/modules/terminal/README.md
@ -1,23 +1,21 @@
-Terminal
+# Terminal
 ========
 Sets terminal window and tab titles.
-Settings
+## Settings
 --------
 ### Auto-Title
 To auto set the terminal window and tab titles with the current command or
-directory, add the following to *zpreztorc*:
+directory, add the following to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:terminal' auto-title 'yes'
 ```
-Auto titling is disabled inside terminal multiplexers (except inside dvtm)
+Auto titling is disabled inside terminal multiplexers (except inside dvtm) since
-since it interferes with window names defined in configuration files and
+it interferes with window names defined in configuration files and profile
-profile managers. This can be overridden by setting it to `always`.
+managers. This can be overridden by setting it to `always`.
 ```sh
 zstyle ':prezto:module:terminal' auto-title 'always'
@ -25,7 +23,7 @@ zstyle ':prezto:module:terminal' auto-title 'always'
 ### Title formats
-To format terminal window and tab titles, add the following to *zpreztorc*:
+To format terminal window and tab titles, add the following to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
@ -38,20 +36,18 @@ executing program name.
 For a list of sequences, see [Expansion of Prompt Sequences][1].
-Functions
+## Functions
 ---------
 - `set-tab-title` sets the terminal tab title.
 - `set-window-title` sets the terminal window title.
 - `set-multiplexer-title` sets the terminal multiplexer title.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Olaf Conradi](https://github.com/oohlaf)
+- [Olaf Conradi](https://github.com/oohlaf)
-[1]: http://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
+[1]: https://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/tmux/README.md
+++ b/modules/tmux/README.md
@ -1,24 +1,22 @@
-Tmux
+# Tmux
 ====
-Defines [tmux][1] aliases and provides for auto launching it at start-up.
+Defines [*tmux*][1] aliases and provides for auto launching it at start-up.
-Settings
+## Settings
 --------
 ### Auto-Start
 Starts a tmux session automatically when Zsh is launched.
-To enable this feature when launching Zsh in a local terminal, add the
+To enable this feature when launching Zsh in a local terminal, add the following
-following line to *zpreztorc*:
+line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:tmux:auto-start' local 'yes'
 ```
-To enable this feature when launching Zsh in a SSH connection, add the
+To enable this feature when launching Zsh in a SSH connection, add the following
-following line to *zpreztorc*:
+line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:tmux:auto-start' remote 'yes'
@ -45,7 +43,7 @@ set-option -g destroy-unattached [on | off]
 #### iTerm2 Integration
 [iTerm2][6] offers significant integration with tmux. This can be enabled by
-adding the following line to *zpreztorc*:
+adding the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:tmux:iterm' integrate 'yes'
@ -53,14 +51,12 @@ zstyle ':prezto:module:tmux:iterm' integrate 'yes'
 Read [iTerm2 and tmux Integration][7] for more information.
-Aliases
+## Aliases
 -------
-  - `tmuxa` attaches or switches to a tmux session.
+- `tmuxa` attaches or switches to a tmux session.
-  - `tmuxl` lists sessions managed by the tmux server.
+- `tmuxl` lists sessions managed by the tmux server.
-Caveats
+## Caveats
 -------
 On macOS, launching tmux can cause the error **launch_msg(...): Socket is not
 connected** to be displayed, which can be fixed by installing
@ -74,20 +70,19 @@ set-option -g default-command "reattach-to-user-namespace -l $SHELL -l"
 Furthermore, tmux is known to cause **kernel panics** on macOS. A discussion
 about this and Prezto has already been [opened][2].
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][5].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-  - [Colin Hebert](https://github.com/ColinHebert)
+- [Colin Hebert](https://github.com/ColinHebert)
-  - [Georges Discry](https://github.com/gdiscry)
+- [Georges Discry](https://github.com/gdiscry)
-  - [Xavier Cambar](https://github.com/xcambar)
+- [Xavier Cambar](https://github.com/xcambar)
-[1]: http://tmux.sourceforge.net
+[1]: https://tmux.github.io/
 [2]: https://github.com/sorin-ionescu/prezto/issues/62
 [3]: https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard
 [4]: https://github.com/mxcl/homebrew
 [5]: https://github.com/sorin-ionescu/prezto/issues
-[6]: http://iterm2.com
+[6]: https://iterm2.com
 [7]: https://gitlab.com/gnachman/iterm2/wikis/TmuxIntegration
--- a/modules/utility/README.md
+++ b/modules/utility/README.md
@ -1,68 +1,67 @@
-Utility
+# Utility
 =======
 Defines general aliases and functions.
-Settings
+## Settings
 --------
 ### Highlighting
-If you have enabled color globally in *zpreztorc*, you may disable it for
+If you have enabled color globally in *~/.zpreztorc*, you may disable it for
 certain commands.
-To disable `ls` color, add the following line to *zpreztorc*; when coloring is
+To disable `ls` color, add the following line to *~/.zpreztorc*; when coloring
-disabled, type indicators (\*, /, =>, @, =, |, %) will be appended to entries.
+is disabled, type indicators (`\*`, `/`, `=>`, `@`, `=`, `|`, `%`) will be
 appended to entries.
 ```sh
 zstyle ':prezto:module:utility:ls' color 'no'
 ```
-To disable GNU coreutils `ls` to list directories grouped first, add the following line to *zpreztorc*:
+To disable GNU coreutils `ls` to list directories grouped first, add the
 following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:utility:ls' dirs-first 'no'
 ```
-To disable `diff` highlighting, add the following line to *zpreztorc*:
+To disable `diff` highlighting, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:utility:diff' color 'no'
 ```
-To disable `wdiff` highlighting, add the following line to *zpreztorc*:
+To disable `wdiff` highlighting, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:utility:wdiff' color 'no'
 ```
-To disable `make` highlighting, add the following line to *zpreztorc*:
+To disable `make` highlighting, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:utility:make' color 'no'
 ```
-Aliases
+## Aliases
 -------
 ### Disabled Spelling Correction
-  - `ack`
+- `ack`
-  - `cd`
+- `cd`
-  - `cp`
+- `cp`
-  - `ebuild`
+- `ebuild`
-  - `gcc`
+- `gcc`
-  - `gist`
+- `gist`
-  - `grep`
+- `grep`
-  - `heroku`
+- `heroku`
-  - `ln`
+- `ln`
-  - `man`
+- `man`
-  - `mkdir`
+- `mkdir`
-  - `mv`
+- `mv`
-  - `mysql`
+- `mysql`
-  - `rm`
+- `rm`
-
+
-To disable all spelling corrections, add the following line to *zpreztorc*:
+To disable all spelling corrections, add the following line to *~/.zpreztorc*:
 ```sh
 zstyle ':prezto:module:utility' correct 'no'
@ -70,122 +69,122 @@ zstyle ':prezto:module:utility' correct 'no'
 ### Disabled File Globbing
-  - `bower`
+- `bower`
-  - `fc`
+- `fc`
-  - `find`
+- `find`
-  - `ftp`
+- `ftp`
-  - `history`
+- `history`
-  - `locate`
+- `locate`
-  - `rake`
+- `rake`
-  - `rsync` (selectively enabled for local files)
+- `rsync` (selectively enabled for local files)
-  - `scp` (selectively enabled for local files)
+- `scp` (selectively enabled for local files)
-  - `sftp`
+- `sftp`
 ### General
-  - `_` executes a command as another user (`sudo`).
+- `_` executes a command as another user (`sudo`).
-  - `b` opens the default web browser.
+- `b` opens the default web browser.
-  - `diffu` shorthand for `diff --unified`
+- `diffu` shorthand for `diff --unified`
-  - `e` opens the default editor.
+- `e` opens the default editor.
-  - `mkdir` creates directories, including intermediary directories.
+- `mkdir` creates directories, including intermediary directories.
-  - `p` opens the default pager.
+- `p` opens the default pager.
-  - `po` removes a directory from the stack and changes to it (`popd`).
+- `po` removes a directory from the stack and changes to it (`popd`).
-  - `pu` changes the directory and pushes the old directory onto the stack
+- `pu` changes the directory and pushes the old directory onto the stack
-    (`pushd`).
+  (`pushd`).
-  - `sa` search aliases for a word.
+- `sa` search aliases for a word.
-  - `type` displays all the attribute values of a shell parameter.
+- `type` displays all the attribute values of a shell parameter.
 ### Files and Directories
-  - `ls` lists with directories grouped first (GNU only).
+- `ls` lists with directories grouped first (GNU only).
-  - `l`  lists in one column, hidden files.
+- `l`  lists in one column, hidden files.
-  - `ll` lists human readable sizes.
+- `ll` lists human readable sizes.
-  - `lr` lists human readable sizes, recursively.
+- `lr` lists human readable sizes, recursively.
-  - `la` lists human readable sizes, hidden files.
+- `la` lists human readable sizes, hidden files.
-  - `lm` lists human readable sizes, hidden files through pager.
+- `lm` lists human readable sizes, hidden files through pager.
-  - `lx` lists sorted by extension (GNU only).
+- `lx` lists sorted by extension (GNU only).
-  - `lk` lists sorted by size, largest last.
+- `lk` lists sorted by size, largest last.
-  - `lt` lists sorted by date, most recent last.
+- `lt` lists sorted by date, most recent last.
-  - `lc` lists sorted by date, most recent last, shows change time.
+- `lc` lists sorted by date, most recent last, shows change time.
-  - `lu` lists sorted by date, most recent last, shows access time.
+- `lu` lists sorted by date, most recent last, shows access time.
-  - `sl` lists directory contents (`ls`).
+- `sl` lists directory contents (`ls`).
 ### macOS Everywhere
-  - `o` opens files and directories (`open` or `xdg-open`).
+- `o` opens files and directories (`open` or `xdg-open`).
-  - `get` downloads files (`curl` or `wget`).
+- `get` downloads files (`curl` or `wget`).
-  - `pbcopy` copies to the pasteboard (`pbcopy`, `xclip` or `xsel`).
+- `pbcopy` copies to the pasteboard (`pbcopy`, `xclip` or `xsel`).
-  - `pbpaste` pastes from the pasteboard (`pbcopy`, `xclip` or `xsel`).
+- `pbpaste` pastes from the pasteboard (`pbcopy`, `xclip` or `xsel`).
-  - `pbc` copies to the pasteboard (`pbcopy`).
+- `pbc` copies to the pasteboard (`pbcopy`).
-  - `pbp` pastes from the pasteboard (`pbpaste`).
+- `pbp` pastes from the pasteboard (`pbpaste`).
 ### Resource Usage
-  - `df` displays free disk space using human readable units (aliases to `pydf`,
+- `df` displays free disk space using human readable units (aliases to `pydf`,
-    if installed).
+  if installed).
-  - `du` displays disk usage using human readable units.
+- `du` displays disk usage using human readable units.
-  - `top` displays information about processes.
+- `top` displays information about processes.
-  - `topc` displays information about processes sorted by CPU usage.
+- `topc` displays information about processes sorted by CPU usage.
-  - `topm` displays information about processes sorted by RAM usage.
+- `topm` displays information about processes sorted by RAM usage.
 ### Safe ops
 By default, `cp`,`ln`, `mv` and `rm` are aliased to their interactive variants.
 If this is not desired, it can be disabled by adding the following line to
-*zpreztorc*:
+*~/.zpreztorc*:
-    zstyle ':prezto:module:utility' safe-ops 'no'.
+```sh
 zstyle ':prezto:module:utility' safe-ops 'no'.
 ```
 In addition, the following aliases have been added:
-  - `cpi` copies files and directories interactively.
+- `cpi` copies files and directories interactively.
-  - `lni` links files and directories interactively.
+- `lni` links files and directories interactively.
-  - `mvi` moves files and directories interactively.
+- `mvi` moves files and directories interactively.
-  - `rmi` removes files and directories interactively.
+- `rmi` removes files and directories interactively.
 ### Miscellaneous
-  - `http-serve` serves a directory via HTTP.
+- `http-serve` serves a directory via HTTP.
-Functions
+## Functions
 ---------
 ### General
-  - `slit` prints columns *1, 2, 3 ... n*.
+- `slit` prints columns *1, 2, 3 ... n*.
 ### Files and Directories
-  - `cdls` changes to a directory and lists its contents.
+- `cdls` changes to a directory and lists its contents.
-  - `dut` displays the grand total disk usage using human readable units.
+- `dut` displays the grand total disk usage using human readable units.
-  - `find-exec` finds files and executes a command on them.
+- `find-exec` finds files and executes a command on them.
-  - `mkdcd` makes a directory and changes to it.
+- `mkdcd` makes a directory and changes to it.
-  - `popdls` pops an entry off the directory stack and lists its contents.
+- `popdls` pops an entry off the directory stack and lists its contents.
-  - `pushdls` pushes an entry onto the directory stack and lists its contents.
+- `pushdls` pushes an entry onto the directory stack and lists its contents.
-  - `noremoteglob` enable local path globbing but disable remote path globbing.
+- `noremoteglob` enable local path globbing but disable remote path globbing.
 ### Developer
-  - `diff` highlights diff output (requires `colordiff`).
+- `diff` highlights diff output (requires `colordiff`).
-  - `make` highlights make output (requires `colormake`).
+- `make` highlights make output (requires `colormake`).
-  - `wdiff` highlights wdiff output (requires `wdiff `or `Git`).
+- `wdiff` highlights wdiff output (requires `wdiff `or `git`).
 ### Resource usage
-  - `psu` displays user owned processes status.
+- `psu` displays user owned processes status.
 ### Search and Replace
-  - `prep` provides a grep-like pattern search.
+- `prep` provides a grep-like pattern search.
-  - `psub` provides a sed-like pattern substitution.
+- `psub` provides a sed-like pattern substitution.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][1].*
-  - [Robby Russell](https://github.com/robbyrussell)
+- [Robby Russell](https://github.com/robbyrussell)
-  - [Suraj N. Kurapati](https://github.com/sunaku)
+- [Suraj N. Kurapati](https://github.com/sunaku)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/wakeonlan/README.md
+++ b/modules/wakeonlan/README.md
@ -1,18 +1,16 @@
-Wake-on-LAN
+# Wake-on-LAN
 ===========
 This module provides a wrapper around the [wakeonlan][1] tool.
-Usage
+## Usage
 -----
-To use this wrapper, create the *~/.wakeonlan* directory, and place in it one
+To use this wrapper, create the *`~/.wakeonlan`* directory, and place in it one
 file for each device you would like to be able to wake. Give the file a name
 that describes the device, such as its hostname.
 Each file should contain a line with the MAC address of the target device and
 the network broadcast address. For instance, there might be a file
-*~/.wakeonlan/leto* with the following contents:
+`*~/.wakeonlan/leto`* with the following contents:
 ```conf
 00:11:22:33:44:55:66 192.168.0.255
@ -20,21 +18,20 @@ the network broadcast address. For instance, there might be a file
 To wake that device, use the following command:
-```sh
+```console
-$ wake leto
+wake leto
 ```
 For more information on the configuration file format, read the
 [wakeonlan man page][2].
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via [issue tracker][3].*
-  - [Paul Dann](https://github.com/giddie)
+- [Paul Dann](https://github.com/giddie)
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: http://gsd.di.uminho.pt/jpo/software/wakeonlan/
-[2]: http://man.cx/wakeonlan
+[2]: https://man.cx/wakeonlan
 [3]: https://github.com/sorin-ionescu/prezto/issues
--- a/modules/yum/README.md
+++ b/modules/yum/README.md
@ -1,28 +1,25 @@
-Yum
+# Yum
 ===
-Defines [yum][1] aliases.
+Defines [*yum*][1] aliases.
-Aliases
+## Aliases
 -------
-  - `yumc` removes package(s) and leaves.
+- `yumc` removes package(s) and leaves.
-  - `yumi` installs package(s).
+- `yumi` installs package(s).
-  - `yumh` displays history.
+- `yumh` displays history.
-  - `yuml` lists packages.
+- `yuml` lists packages.
-  - `yumL` lists installed packages.
+- `yumL` lists installed packages.
-  - `yumq` displays package information.
+- `yumq` displays package information.
-  - `yumr` removes package(s).
+- `yumr` removes package(s).
-  - `yums` searches for a package.
+- `yums` searches for a package.
-  - `yumu` updates packages.
+- `yumu` updates packages.
-  - `yumU` upgrades packages.
+- `yumU` upgrades packages.
-Authors
+## Authors
 -------
 *The authors of this module should be contacted via the [issue tracker][2].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
 [1]: http://yum.baseurl.org
 [2]: https://github.com/sorin-ionescu/prezto/issues
--- a/runcoms/README.md
+++ b/runcoms/README.md
@ -1,34 +1,32 @@
-Configuration Files
+# Configuration Files
 ===================
 Zsh has several system-wide and user-local configuration files.
 Prezto has one user-local configuration file.
 System-wide configuration files are installation-dependent but are installed
-in */etc* by default.
+in *`/etc`* by default.
 User-local configuration files have the same name as their global counterparts
 but are prefixed with a dot (hidden). Zsh looks for these files in the path
 stored in the `$ZDOTDIR` environment variable. However, if said variable is
 not defined, Zsh will use the user's home directory.
-File Descriptions
+## File Descriptions
 -----------------
 The configuration files are read in the following order:
-  01. /etc/zshenv
+01. */etc/zshenv*
-  02. ~/.zshenv
+02. *~/.zshenv*
-  03. /etc/zprofile
+03. */etc/zprofile*
-  04. ~/.zprofile
+04. *~/.zprofile*
-  05. /etc/zshrc
+05. */etc/zshrc*
-  06. ~/.zshrc
+06. *~/.zshrc*
-  07. ~/.zpreztorc
+07. *~/.zpreztorc*
-  08. /etc/zlogin
+08. */etc/zlogin*
-  09. ~/.zlogin
+09. *~/.zlogin*
-  10. ~/.zlogout
+10. *~/.zlogout*
-  11. /etc/zlogout
+11. */etc/zlogout*
 ### zshenv
@ -37,16 +35,16 @@ small as possible and should only define environment variables.
 ### zprofile
-This file is similar to zlogin, but it is sourced before zshrc. It was added
+This file is similar to *zlogin*, but it is sourced before *zshrc*. It was added
-for [KornShell][1] fans. See the description of zlogin below for what it may
+for [KornShell][1] fans. See the description of *zlogin* below for what it may
 contain.
-zprofile and zlogin are not meant to be used concurrently but can be done so.
+*zprofile* and *zlogin* are not meant to be used together but can be done so.
 ### zshrc
-This file is sourced by interactive shells. It should define aliases,
+This file is sourced by interactive shells. It should define aliases, functions,
-functions, shell options, and key bindings.
+shell options, and key bindings.
 ### zpreztorc
@ -54,9 +52,9 @@ This file configures Prezto.
 ### zlogin
-This file is sourced by login shells after zshrc, and thus, it should contain
+This file is sourced by login shells after *zshrc*. Thus, it should contain
 commands that need to execute at login. It is usually used for messages such as
-[fortune][2], [msgs][3], or for the creation of files.
+[*fortune*][2], [*msgs*][3], or for the creation of files.
 This is not the file to define aliases, functions, shell options, and key
 bindings. It should not change the shell environment.
@ -64,16 +62,15 @@ bindings. It should not change the shell environment.
 ### zlogout
 This file is sourced by login shells during logout. It should be used for
-displaying messages and the deletion of files.
+displaying messages and for deletion of files.
-Authors
+## Authors
 -------
 *The authors of these files should be contacted via the [issue tracker][4].*
-  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+- [Sorin Ionescu](https://github.com/sorin-ionescu)
-[1]: http://www.kornshell.com
+[1]: https://www.kornshell.com
-[2]: http://en.wikipedia.org/wiki/Fortune_(Unix)
+[2]: https://en.wikipedia.org/wiki/Fortune_(Unix)
-[3]: http://www.manpagez.com/man/1/msgs
+[3]: https://www.manpagez.com/man/1/msgs
 [4]: https://github.com/sorin-ionescu/prezto/issues