diff --git a/docs/fix/fix.md b/docs/fix/fix.md
index 63e36ce..087f940 100644
--- a/docs/fix/fix.md
+++ b/docs/fix/fix.md
@@ -15,5 +15,5 @@ The transformation itself is declared in a fix-object which can be a file. For m
 
 See [here a list for all available FIX functions and a cookbook for using fix](//docs/fix/Fix-functions-and-Cookbook.html).
 
-> [!NOTE]
+{: .note }
 > PS: There is also the transformation modul MORPH. Have a look at[ the old documentation](https://github.com/metafacture/metafacture-core/wiki/Metamorph-User-Guide) and the german cookbook by [Swissbib](https://swissbib.gitlab.io/metamorph-doku/).
\ No newline at end of file
diff --git a/docs/flux/Flux-User-Guide.md b/docs/flux/Flux-User-Guide.md
index d5f9387..1049fe6 100644
--- a/docs/flux/Flux-User-Guide.md
+++ b/docs/flux/Flux-User-Guide.md
@@ -121,7 +121,7 @@ Flux supports single line C/Java-style comments: `//comment`.
 _________________________
 ## For developers: 
 
-> [!NOTE]
+{: .note }
 > Coding in JAVA.
 
 ### Adding new Commands
diff --git a/docs/java-integration/Framework-User-Guide.md b/docs/java-integration/Framework-User-Guide.md
index e987add..b38e079 100644
--- a/docs/java-integration/Framework-User-Guide.md
+++ b/docs/java-integration/Framework-User-Guide.md
@@ -7,8 +7,8 @@ nav_order: 1
 
 # Framework User Guide
 
-> [!NOTE]
->Relevant for Java developers. For using metafacture without Java Code see the [FLUX user guide](/docs/flux/Flux-User-Guide.html).
+{: .note }
+> Relevant for Java developers. For using metafacture without Java Code see the [FLUX user guide](/docs/flux/Flux-User-Guide.html).
 
 This page explains how to create a Metafacture objects and how to assemble them to form a processing pipeline. We use as an example a simple pipeline containing a Metafix instance.
 
diff --git a/docs/java-integration/java-integration.md b/docs/java-integration/java-integration.md
index 772d082..1d64011 100644
--- a/docs/java-integration/java-integration.md
+++ b/docs/java-integration/java-integration.md
@@ -7,8 +7,8 @@ has_children: true
 
 ## Framework for Java integration/development
 
-> [!NOTE]
->Relevant for developers
+{: .note }
+> Relevant for developers
 
 The framework includes the interfaces and abstract classes which form the foundation of the data processing pipelines. This part of Metafacture is only relevant for you if you plan to use Metafacture as a Java library or if you wish to add pipe elements to Flux.
 
diff --git a/index.md b/index.md
index b841e7c..aed69b8 100644
--- a/index.md
+++ b/index.md
@@ -16,7 +16,7 @@ This is the central place for the documentation about Metafacture.
 
 Metafacture comprises three main parts: **Framework**, **Flux** and one of the **Transformation-Modules Fix and Morph**. It can be extended with modules.
 
-> [!NOTE]
+{: .note }
 > With regard to the Transformation-Modules this documentation focusses on Fix instead of MORPH. If you want to find out more about MORPH. Have a look at [the old documentation](https://github.com/metafacture/metafacture-core/wiki/Metamorph-User-Guide) and the german cookbook by [Swissbib](https://swissbib.gitlab.io/metamorph-doku/).
 
 
@@ -28,7 +28,7 @@ Deciding which parts are relevant to you depends on the way you are using Metafa
 
 ## Using Metafacture via playground or CLI
 
-> [!NOTE]
+{: .note }
 > No Java-Code is necessary!!!
 
 While working with the playground or the command line you only need [Flux](/docs/flux/flux.html) and the transformation module [Fix](/docs/fix/fix.html).