diff --git a/resources/score-compose.md b/resources/score-compose.md
index e06874b..43e44f6 100644
--- a/resources/score-compose.md
+++ b/resources/score-compose.md
@@ -1,4 +1,4 @@
-## Initialize your local workspace
+Initialize your local workspace
 
 This will use the default provisioners, you can use other provisioners instead like illustrated [here](https://github.dev/score-spec/community-provisioners).
 
@@ -6,19 +6,19 @@ This will use the default provisioners, you can use other provisioners instead l
 score-commpose init
 ```
 
-## Get the provisioner definition
+Get the provisioner definition
 
 ```bash
 score-compose provisioners list
 ```
 
-## Generate the platform specific manifests
+Generate the platform specific manifests
 
 ```bash
 score-commpose generate score.yaml
 ```
 
-## See the resource outputs
+See the resource outputs
 
 ```bash
 score-commpose resources list
@@ -26,14 +26,14 @@ score-commpose resources list
 
 You can run `score-compose resources get-outputs` on each resource listed to get their `outputs`.
 
-## Deploy the generated manifests
+Deploy the generated manifests
 
 ```bash
 docker compose up -d
 ```
 
-## See the running containers
+See the running containers
 
 ```bash
 docker ps
-```
\ No newline at end of file
+```
diff --git a/resources/score-k8s.md b/resources/score-k8s.md
index 2a74845..41bf06e 100644
--- a/resources/score-k8s.md
+++ b/resources/score-k8s.md
@@ -1,4 +1,4 @@
-## Initialize your local workspace
+Initialize your local workspace
 
 This will use the default provisioners, you can use other provisioners instead like illustrated [here](https://github.dev/score-spec/community-provisioners).
 
@@ -6,19 +6,19 @@ This will use the default provisioners, you can use other provisioners instead l
 score-k8s init
 ```
 
-## Get the provisioner definition
+Get the provisioner definition
 
 ```bash
 score-k8s provisioners list
 ```
 
-## Generate the platform specific manifests
+Generate the platform specific manifests
 
 ```bash
 score-k8s generate score.yaml
 ```
 
-## See the resource outputs
+See the resource outputs
 
 ```bash
 score-k8s resources list
@@ -26,14 +26,14 @@ score-k8s resources list
 
 You can run `score-k8s resources get-outputs` on each resource listed to get their `outputs`.
 
-## Deploy the generated manifests
+Deploy the generated manifests
 
 ```bash
 kubectl apply -f manifests.yaml
 ```
 
-## See the running containers
+See the running containers
 
 ```bash
 kubectl get all
-```
\ No newline at end of file
+```
diff --git a/specification/score-compose.md b/specification/score-compose.md
index 442ea01..938b289 100644
--- a/specification/score-compose.md
+++ b/specification/score-compose.md
@@ -1,23 +1,23 @@
-## Initialize your local workspace
+Initialize your local workspace
 
 ```bash
 score-compose init
 ```
 
-## Generate the platform specific manifests
+Generate the platform specific manifests
 
 ```bash
 score-compose generate score.yaml --image busybox
 ```
 
-## Deploy the generated manifests
+Deploy the generated manifests
 
 ```bash
 docker compose up -d
 ```
 
-## See the running containers
+See the running containers
 
 ```bash
 docker ps
-```
\ No newline at end of file
+```
diff --git a/specification/score-k8s.md b/specification/score-k8s.md
index 046c763..b4235f8 100644
--- a/specification/score-k8s.md
+++ b/specification/score-k8s.md
@@ -1,23 +1,23 @@
-## Initialize your local workspace
+Initialize your local workspace
 
 ```bash
 score-k8s init
 ```
 
-## Generate the platform specific manifests
+Generate the platform specific manifests
 
 ```bash
 score-k8s generate score.yaml --image busybox
 ```
 
-## Deploy the generated manifests
+Deploy the generated manifests
 
 ```bash
 kubectl apply -f manifests.yaml
 ```
 
-## See the running containers
+See the running containers
 
 ```bash
 kubectl get all
-```
\ No newline at end of file
+```