diff --git a/Diagnostic-information.md b/Diagnostic-information.md
index 72ed48a..1f74c76 100644
--- a/Diagnostic-information.md
+++ b/Diagnostic-information.md
@@ -1,16 +1,10 @@
+# Diagnostic information
+
SQLite running in sqliteviz is compiled with particular [options][1] that can
enable or disable some SQLite features. You can get a list of them in `App
-info` dialog (fig. 1) by clicking on
icon in the top
+info` dialog (fig. 1) by clicking on  icon in the top
toolbar.
-
-
-
-
-
-
- Fig. 1: App info dialog
-
-
+
[1]: https://sqlite.org/compile.html
diff --git a/Export-current-database.md b/Export-current-database.md
index e02baa0..c7daf6f 100644
--- a/Export-current-database.md
+++ b/Export-current-database.md
@@ -1,4 +1,6 @@
+# Export current database
+
Sqliteviz allows running not only `SELECT` statements but DML/DDL statements
too. You can save database modifications into a `.sqlite` file by clicking on
-icon
next to the database name on `Workspace`
+icon  next to the database name on `Workspace`
page.
diff --git a/How-to-build-a-pivot-table-in-SQLite.md b/How-to-build-a-pivot-table-in-SQLite.md
index c570810..786556d 100644
--- a/How-to-build-a-pivot-table-in-SQLite.md
+++ b/How-to-build-a-pivot-table-in-SQLite.md
@@ -1,7 +1,9 @@
+# How to build a pivot table in SQLite
+
This how-to explores how to build pivot tables in SQLite, which doesn't have a
special constructs like `PIVOT` or `CROSSTAB` in its SQL dialect.
-# Static-column pivot table
+## Static-column pivot table
If the columns of a pivot table are known beforehand, it's possible to write a
standard, say SQL-92, query that would produce a pivot table in its result set.
@@ -87,7 +89,7 @@ ORDER BY
END
```
-# Dynamic-column pivot table
+## Dynamic-column pivot table
SQLite in sqliteviz is built with [pivot_vtab][2] extension. The same result set
can be produced with this, arguably simpler and more maintainable, query.
diff --git a/How-to-rename-tables-and-columns-after-CSV-import.md b/How-to-rename-tables-and-columns-after-CSV-import.md
index 887e23c..7a7dbb5 100644
--- a/How-to-rename-tables-and-columns-after-CSV-import.md
+++ b/How-to-rename-tables-and-columns-after-CSV-import.md
@@ -1,4 +1,6 @@
-# Rename columns
+# How to rename tables and columns after CSV import
+
+## Rename columns
If sqliteviz parses CSV without `Use first row as column headers` option then
it will name the columns like `col1`, `col2` etc. You can easily rename the
@@ -9,7 +11,7 @@ ALTER TABLE your_table_name
RENAME COLUMN current_column_name TO new_column_name;
```
-## Column rename example
+### Column rename example
There is a table `dots` with columns `col1`, `col2`, `col3`. Here are the steps
to rename the columns to `x`, `y` and `z` respectively:
@@ -28,17 +30,17 @@ ALTER TABLE dots
RENAME COLUMN col3 TO z;
```
-- Click
to run the script
+- Click  to run the script
-# Rename table
+## Rename table
```sql
ALTER TABLE current_table_name
RENAME TO new_table_name;
```
-## Table rename example
+### Table rename example
There is a table `dots`. Here are the steps to rename it to `point`:
@@ -49,4 +51,4 @@ There is a table `dots`. Here are the steps to rename it to `point`:
ALTER TABLE dots RENAME TO point
```
-- Click
to run the script
+- Click  to run the script
diff --git a/Installation.md b/Installation.md
index aa5f24e..8b38e4e 100644
--- a/Installation.md
+++ b/Installation.md
@@ -1,3 +1,5 @@
+# Installation
+
The latest release of sqliteviz is running on [Github pages][1].
Basically, you don't need to install sqliteviz. But if you want you can install
diff --git a/Integrate-predefined-inquiries.md b/Integrate-predefined-inquiries.md
index e50c471..70550d8 100644
--- a/Integrate-predefined-inquiries.md
+++ b/Integrate-predefined-inquiries.md
@@ -1,3 +1,5 @@
+# Integrate predefined inquiries
+
If you run sqliteviz on your own server you can specify predefined inquiries.
These inquiries will appear in `Inquiries` list for all users working with
sqliteviz on your server.
diff --git a/Manage-inquiries.md b/Manage-inquiries.md
index a794806..8db4b47 100644
--- a/Manage-inquiries.md
+++ b/Manage-inquiries.md
@@ -1,19 +1,18 @@
-# Organise
+# Manage inquiries
+
+## Organise
You can find all inquiries that you saved in `Inquiries` (fig. 1).
-
-
- Fig. 1: Inquiries
+
To manipulate one inquiry hover the cursor over the row with the inquiry and
choose the action:
-*
– rename an inquiry
-*
– duplicate an inquiry
-*
– export an inquiry to JSON file
-*
– delete an inquiry
+*  – rename an inquiry
+*  – duplicate an inquiry
+*  – export an inquiry to JSON file
+*  – delete an inquiry
To edit a query or visualisation settings of an inquiry click on the respective
row. You will be redirected to `Workspace` where the chosen inquiry will be
@@ -27,19 +26,14 @@ You can also delete or export a group of inquiries to a JSON file. Select
inquiries with checkboxes and press `Delete`/`Export` button above the grid
(fig. 2).
-
-
-
- Fig. 2: Inquiries: a group of inquiries is selected
-
+
> **Note:** Some operations are not available for predefined inquiries. Read
> [Predefined inquiries][1] for details.
-# Import
+## Import
Click `Import` button on `Inquiries` page to import inquiries from a JSON file
generated by export.
-[1]: Predefined-inquiries
+[1]: ../Predefined-inquiries
diff --git a/Multiple-CSV-file-import.md b/Multiple-CSV-file-import.md
index 9c40426..24f07b5 100644
--- a/Multiple-CSV-file-import.md
+++ b/Multiple-CSV-file-import.md
@@ -1,10 +1,12 @@
+# Multiple CSV file import
+
Sometimes it's useful to import several CSV files as tables in one database. For
example, to be able to `JOIN` them in SQL.
In sqliteviz you can not only create a database from a CSV file, but also add
another table from CSV to the existing database.
-- Click
icon in the schema panel on `Workspace`
+- Click  icon in the schema panel on `Workspace`
page
- Choose a CSV file
- Import it with `CSV import` dialog.
diff --git a/Pivot-table.md b/Pivot-table.md
index 737a569..92755e8 100644
--- a/Pivot-table.md
+++ b/Pivot-table.md
@@ -1,9 +1,10 @@
-# Pivot table UI
+# Pivot table
+
+## Pivot table UI
Sqliteviz allows building pivot tables and visualizing them. To build a pivot
-run a query to get data. Then open visualisation panel by clicking
in any of the two side toolbars and choose a
-pivot mode by clicking
.
+run a query to get data. Then open visualisation panel by clicking 
+in any of the two side toolbars and choose a pivot mode by clicking .
A pivot visualisation has the following settings:
@@ -18,54 +19,24 @@ A pivot visualisation has the following settings:
- View – pivot table visualisation. It can be a table, a heatmap, a chart,
etc. See some examples of different views of the same pivot table below.
-
-
-
-
-
- Fig. 1: Table
-
-
+
-
-
-
-
-
- Fig. 2: Heatmap
-
-
+
-
-
-
-
-
- Fig. 3: Horizontal Stacked Bar Chart
-
-
+
There are several built-in chart views for a pivot. But you can build your own
with `Custom chart` view (fig. 4).
-
-
-
-
-
- Fig. 4: Custom Chart
-
-
+
> **Note:** You can switch to other pivot views and back to `Custom chart` –
> all your custom chart settings will be remembered. But if you switch the
> visualisation mode from pivot to any other mode, unsaved changes will be lost.
-You can save any visualisation as an image by clicking
.
+You can save any visualisation as an image by clicking .
-# Pivot table SQL
+## Pivot table SQL
Pivot table (in the form of a result set) can be built on the SQL-level and,
technically speaking, can be visualised as any other result set. Practically
diff --git a/Predefined-inquiries.md b/Predefined-inquiries.md
index 582acf7..2e825ee 100644
--- a/Predefined-inquiries.md
+++ b/Predefined-inquiries.md
@@ -1,3 +1,5 @@
+# Predefined inquiries
+
Predefined inquiries come out of the box on the sqliteviz instance. In sqliteviz
deployed on [Github Pages][1] there are no predefined inquiries, but you may
see them if you use sqliteviz integrated into another app.
@@ -5,15 +7,7 @@ see them if you use sqliteviz integrated into another app.
These inquiries are shown in `Inqueries` list with a special label on the mouse
over (fig. 1).
-
-
-
-
-
- Fig. 1: Predefined inquiry
-
-
+
As a user, you can't rename or delete a predefined inquiry. You can't save
changes in a predefined inquiry, but you can save them as a new inquiry. The