Add a bunch of markdown extensions

docs/en/operations/performance_test.md

@@ -2,13 +2,13 @@
 
 With this instruction you can run basic ClickHouse performance test on any server without installation of ClickHouse packages.
 
-\1. Go to "commits" page: [https://github.com/ClickHouse/ClickHouse/commits/master](https://github.com/ClickHouse/ClickHouse/commits/master)
+1. Go to "commits" page: https://github.com/ClickHouse/ClickHouse/commits/master
 
-\2. Click on the first green check mark or red cross with green "ClickHouse Build Check" and click on the "Details" link near "ClickHouse Build Check".
+2. Click on the first green check mark or red cross with green "ClickHouse Build Check" and click on the "Details" link near "ClickHouse Build Check".
 
-\3. Copy the link to "clickhouse" binary for amd64 or aarch64.
+3. Copy the link to "clickhouse" binary for amd64 or aarch64.
 
-\4. ssh to the server and download it with wget:
+4. ssh to the server and download it with wget:
 ```
 # For amd64:
 wget https://clickhouse-builds.s3.yandex.net/0/00ba767f5d2a929394ea3be193b1f79074a1c4bc/1578163263_binary/clickhouse
@@ -18,7 +18,7 @@ wget https://clickhouse-builds.s3.yandex.net/0/00ba767f5d2a929394ea3be193b1f7907
 chmod a+x clickhouse
 ```
 
-\5. Download configs:
+5. Download configs:
 ```
 wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/programs/server/config.xml
 wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/programs/server/users.xml
@@ -27,50 +27,42 @@ wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/program
 wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/programs/server/config.d/log_to_console.xml -O config.d/log_to_console.xml
 ```
 
-\6. Download benchmark files:
+6. Download benchmark files:
 ```
 wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/benchmark/clickhouse/benchmark-new.sh
 chmod a+x benchmark-new.sh
 wget https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/dbms/benchmark/clickhouse/queries.sql
 ```
 
-\7. Download test data:
-
-According to the instruction:
-
-[https://clickhouse.tech/docs/en/getting_started/example_datasets/metrica/](https://clickhouse.yandex/docs/en/getting_started/example_datasets/metrica/)
-
-("hits" table containing 100 million rows)
+7. Download test data according to the [Yandex.Metrica dataset](../getting_started/example_datasets/metrica.md) instruction ("hits" table containing 100 million rows).
 
 ```
 wget https://clickhouse-datasets.s3.yandex.net/hits/partitions/hits_100m_obfuscated_v1.tar.xz
 tar xvf hits_100m_obfuscated_v1.tar.xz -C .
 mv hits_100m_obfuscated_v1/* .
 ```
 
-\8. Run the server:
+8. Run the server:
 ```
 ./clickhouse server
 ```
 
-\9. Check the data:
-
-ssh to the server in another terminal
+9. Check the data: ssh to the server in another terminal
 ```
 ./clickhouse client --query "SELECT count() FROM hits_100m_obfuscated"
 100000000
 ```
 
-\10. Edit the benchmark-new.sh, change "clickhouse-client" to "./clickhouse client" and add "--max_memory_usage 100000000000" parameter.
+10. Edit the benchmark-new.sh, change "clickhouse-client" to "./clickhouse client" and add "--max_memory_usage 100000000000" parameter.
 ```
 mcedit benchmark-new.sh
 ```
 
-\11. Run the benchmark:
+11. Run the benchmark:
 ```
 ./benchmark-new.sh hits_100m_obfuscated
 ```
 
-\12. Send the numbers and the info about your hardware configuration to clickhouse-feedback@yandex-team.com
+12. Send the numbers and the info about your hardware configuration to clickhouse-feedback@yandex-team.com
 
-All the results are published here: [https://clickhouse.tech/benchmark_hardware.html](https://clickhouse.yandex/benchmark_hardware.html)
+All the results are published here: https://clickhouse.tech/benchmark_hardware.html

docs/tools/build.py

@@ -21,6 +21,7 @@
 from concatenate import concatenate
 
 from website import build_website, minify_website
+
 import mdx_clickhouse
 import test
 import util
@@ -109,6 +110,10 @@ def build_for_lang(lang, args):
                 'admonition',
                 'attr_list',
                 'codehilite',
+                'nl2br',
+                'sane_lists',
+                'pymdownx.magiclink',
+                'pymdownx.superfences',
                 'extra',
                 {
                     'toc': {

docs/tools/requirements.txt

@@ -23,6 +23,7 @@ nose==1.3.7
 numpy==1.15.4
 protobuf==3.6.1
 Pygments==2.5.2
+pymdown-extensions==6.3
 python-slugify==1.2.6
 PyYAML==5.3
 repackage==0.7.3