diff --git a/Mage.Client/pom.xml b/Mage.Client/pom.xml
index 929e7931ca..8fe1db8efc 100644
--- a/Mage.Client/pom.xml
+++ b/Mage.Client/pom.xml
@@ -215,6 +215,10 @@
                     </descriptors>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>com.ruleoftech</groupId>
+                <artifactId>markdown-page-generator-plugin</artifactId>
+            </plugin>
         </plugins>
 
         <finalName>mage-client</finalName>
diff --git a/Mage.Client/src/main/assembly/distribution.xml b/Mage.Client/src/main/assembly/distribution.xml
index 9b7e36f761..ddf248c1b1 100644
--- a/Mage.Client/src/main/assembly/distribution.xml
+++ b/Mage.Client/src/main/assembly/distribution.xml
@@ -37,8 +37,16 @@
             <filtered>true</filtered>
             <directory>../</directory>
             <includes>
-                <include>readme.md</include>
                 <include>LICENSE.txt</include>
+                <include>readme.md</include>
+            </includes>
+            <outputDirectory>/</outputDirectory>
+        </fileSet>
+        <fileSet>
+            <filtered>true</filtered>
+            <directory>${project.build.directory}/docs/</directory>
+            <includes>
+                <include>readme.html</include>
             </includes>
             <outputDirectory>/</outputDirectory>
         </fileSet>
diff --git a/Mage.Server.Console/pom.xml b/Mage.Server.Console/pom.xml
index f67ab5e777..4d9a46a3ec 100644
--- a/Mage.Server.Console/pom.xml
+++ b/Mage.Server.Console/pom.xml
@@ -62,6 +62,10 @@
                     </descriptors>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>com.ruleoftech</groupId>
+                <artifactId>markdown-page-generator-plugin</artifactId>
+            </plugin>
         </plugins>
 
         <finalName>mage-serverconsole</finalName>
diff --git a/Mage.Server.Console/src/main/assembly/distribution.xml b/Mage.Server.Console/src/main/assembly/distribution.xml
index 835b3b3936..d63170b63c 100644
--- a/Mage.Server.Console/src/main/assembly/distribution.xml
+++ b/Mage.Server.Console/src/main/assembly/distribution.xml
@@ -28,8 +28,16 @@
             <filtered>true</filtered>
             <directory>../</directory>
             <includes>
-                <include>readme.md</include>
                 <include>LICENSE.txt</include>
+                <include>readme.md</include>
+            </includes>
+            <outputDirectory>/</outputDirectory>
+        </fileSet>
+        <fileSet>
+            <filtered>true</filtered>
+            <directory>${project.build.directory}/docs/</directory>
+            <includes>
+                <include>readme.html</include>
             </includes>
             <outputDirectory>/</outputDirectory>
         </fileSet>
diff --git a/Mage.Server/pom.xml b/Mage.Server/pom.xml
index 0576da6a36..bd4636a455 100644
--- a/Mage.Server/pom.xml
+++ b/Mage.Server/pom.xml
@@ -352,6 +352,10 @@
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
             </plugin>
+            <plugin>
+                <groupId>com.ruleoftech</groupId>
+                <artifactId>markdown-page-generator-plugin</artifactId>
+            </plugin>
         </plugins>
 
         <finalName>mage-server</finalName>
diff --git a/Mage.Server/src/main/assembly/distribution.xml b/Mage.Server/src/main/assembly/distribution.xml
index f21baff9fd..62ccfe1034 100644
--- a/Mage.Server/src/main/assembly/distribution.xml
+++ b/Mage.Server/src/main/assembly/distribution.xml
@@ -54,8 +54,16 @@
             <filtered>true</filtered>
             <directory>../</directory>
             <includes>
-                <include>readme.md</include>
                 <include>LICENSE.txt</include>
+                <include>readme.md</include>
+            </includes>
+            <outputDirectory>/</outputDirectory>
+        </fileSet>
+        <fileSet>
+            <filtered>true</filtered>
+            <directory>${project.build.directory}/docs/</directory>
+            <includes>
+                <include>readme.html</include>
             </includes>
             <outputDirectory>/</outputDirectory>
         </fileSet>
diff --git a/pom.xml b/pom.xml
index f53baf3db2..5364e32922 100644
--- a/pom.xml
+++ b/pom.xml
@@ -116,11 +116,34 @@
                     <version>2.7</version>
                 </plugin>
 
+                <!-- devs only: allows to run apps from command line by exec:java command -->
                 <plugin>
                     <groupId>org.codehaus.mojo</groupId>
                     <artifactId>exec-maven-plugin</artifactId>
                     <version>3.0.0</version>
                 </plugin>
+
+                <!-- generate readable readme file for releases -->
+                <!-- results uses in distribution.xml -->
+                <!-- https://github.com/walokra/markdown-page-generator-plugin -->
+                <plugin>
+                    <groupId>com.ruleoftech</groupId>
+                    <artifactId>markdown-page-generator-plugin</artifactId>
+                    <version>2.4.0</version>
+                    <executions>
+                        <execution>
+                            <phase>process-resources</phase>
+                            <goals>
+                                <goal>generate</goal>
+                            </goals>
+                        </execution>
+                    </executions>
+                    <configuration>
+                        <inputDirectory>../</inputDirectory>
+                        <inputFileExtensions>md</inputFileExtensions>
+                        <outputDirectory>${project.build.directory}/docs</outputDirectory>
+                    </configuration>
+                </plugin>
             </plugins>
         </pluginManagement>
     </build>