diff --git a/README.md b/README.md
index 9cfa670..7a13190 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,22 @@
 [![Build Actions Status](https://github.com/yantonov/alias/workflows/ci/badge.svg)](https://github.com/yantonov/alias/actions)
 
-### Intro
+# Intro
 
 This app helps you to define a custom alias for a command-line utility that has no [alias support](https://git-scm.com/docs/git-config#Documentation/git-config.txt-alias).  
 Using this app you can define some aliases (including shell aliases) and use them just like they were defined out of the box.  
 Therefore, you do not need to pollute a global namespace with shell aliases (using .zsh/.bashrc/.profile etc).  
 
-### Technical notes
+# Table of contents
+1. [Technical notes](#technical-notes)
+2. [Usage](#usage)
+3. [List of aliases](#list-of-aliases)
+4. [Override](#override)
+5. [Target executable location](#target-executable-location)
+6. [Different operating systems](#different-operating-systems)
+7. [Shell scripts on Windows](#shell-scripts-on-windows)
+8. [Examples](#examples)
+
+## Technical notes
 Technically is just a thin wrapper(proxy) to conditionally run target program.  
 
 This app is independent of
@@ -14,33 +24,33 @@ This app is independent of
 2. operating system
 3. shell/command interpreter
 
-### Usage
+## Usage
 1. Put the executable to PATH, and name it the same as the target program (program without alias support)  
 You can get prebuilt binaries [here](https://github.com/yantonov/alias/releases)
 2. Write config (config.toml) and put it near the executable  
 (a sample config will be created at the first launch if it does not exist)
 3. Use custom aliases just like if they are supported out of the box.  
 
-### About list of aliases
+### List of aliases
 The list of aliases can be shown by using --aliases parameter.
 
-### About overriding configuration
+### Override
 You can add an additional configuration file 'override.toml' to the same directory.  
 This helps you to redefine or introduce new aliases which depend on the environment.  
 Motivation: some aliases may be specific to the working environment and you do not want to expose them by sharing using a public repository.
 
-### About target executable location
+### Target executable location
 There are two options:  
 1. You can explicitly define the target executable using 'executable' parameter (see the example [here](https://github.com/yantonov/alias/blob/master/docs/sample_config.toml)).  
 2. Without explicit configuration, the app tries to detect the target executable automatically by trying to find an existing file with the same name later in the PATH.  
 In that case, you have to add this alias application in front of the target executable in terms of the PATH variable.
 
-### About different operating systems
+### Different operating systems
 Different operating systems place binary files in different directories.  
 To handle this, it is possible to reference target executable using environment variables (example: executable="${HOME}/tools/bin/app")  
 This helps you to use the same config file across different operating systems.
 
-### About using shell scripts on Windows
+### Shell scripts on Windows
 When you try to use shell script directly as a target executable you can face the problem '%1 is not a valid win32 application'.  
 To deal with this issue you can ann run_as_shell=true parameter to the config (or to the override file if you prefer), this will allows you to run the script using the current shell.