diff --git a/README.md b/README.md
index 1c267c527..bbd84e3e7 100644
--- a/README.md
+++ b/README.md
@@ -1,22 +1,15 @@
 
-**ecFlow**
-==========
+# ecFlow
 
-.. raw:: html
+<div align="center">
+  <a href="https://github.com/ecmwf/codex/raw/refs/heads/main/ESEE"><img src="https://github.com/ecmwf/codex/raw/refs/heads/main/ESEE/production_chain_badge.svg" alt="Static Badge"></a>
+  &nbsp;
+  <a href="https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity"><img src="https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity/graduated_badge.svg" alt="Static Badge"></a>
+</div>
 
-    <div align="center">
-      <a href="https://github.com/ecmwf/codex/raw/refs/heads/main/ESEE"><img src="https://github.com/ecmwf/codex/raw/refs/heads/main/ESEE/production_chain_badge.svg" alt="Static Badge"></a>
-      &nbsp;
-      <a href="https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity"><img src="https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity/graduated_badge.svg" alt="Static Badge"></a>
-    </div>
 
-
-.. raw:: html
-
-    <table align="center" style="width: 100%; border=0; cellspacing=0; cellpadding=0; border-collapse: collapse;">
-      <tr><td>⚠️ <strong>Important</strong></td></tr>
-      <tr><td>This software is <strong>Graduated</strong> and subject to ECMWF's guidelines on <a href="https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity">Software Maturity</a>.</td></tr>
-    </table>
+> [!IMPORTANT]
+> This software is **Graduated** and subject to ECMWF's guidelines on [Software Maturity](https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity).
 
 
 *ecFlow* is a client/server workflow package that enables users to run a large number of programs (with dependencies on each other and on time) in a controlled environment. It provides tolerance for hardware and software failures, combined with restart capabilities. It is used at ECMWF to run all our operational suites across a range of platforms.
@@ -24,8 +17,7 @@
 The documentation can be found at https://ecflow.readthedocs.io/.
 
 
-COPYRIGHT AND LICENCE
-----------------------
+## COPYRIGHT AND LICENCE
 
 Copyright 2005- European Centre for Medium-Range Weather Forecasts (ECMWF).