📝 Improved markdown

Author: pboling

README.md

@@ -94,26 +94,26 @@ docker compose -f docker-compose-ssl.yml down
 Troubleshooting: validate connectivity to the mock server
 
 - Check container status and port mapping:
-    - docker compose -f docker-compose-ssl.yml ps
+    - `docker compose -f docker-compose-ssl.yml ps`
 - From the host, try the discovery URL directly (this is what the example uses by default):
-    - curl -v http://localhost:8080/default/.well-known/openid-configuration
-    - If that fails immediately, also try: curl -v --connect-timeout 2 http://127.0.0.1:8080/default/.well-known/openid-configuration
-- From inside the container (to distinguish container vs host networking):
-    - docker exec -it oauth2-mock-oauth2-server-1 curl -v http://127.0.0.1:8080/default/.well-known/openid-configuration
+    - `curl -v http://localhost:8080/default/.well-known/openid-configuration`
+    - If that fails immediately, also try: `curl -v --connect-timeout 2 http://127.0.0.1:8080/default/.well-known/openid-configuration`
+- From inside the container (to distinguish container vs. host networking):
+    - `docker exec -it oauth2-mock-oauth2-server-1 curl -v http://127.0.0.1:8080/default/.well-known/openid-configuration`
 - Simple TCP probe from the host:
-    - nc -vz localhost 8080  # or: ruby -rsocket -e 'TCPSocket.new("localhost",8080).close; puts "tcp ok"'
+    - `nc -vz localhost 8080  # or: ruby -rsocket -e 'TCPSocket.new("localhost",8080).close; puts "tcp ok"'`
 - Inspect which host port 8080 is bound to (should be 8080):
-    - docker inspect -f '{{ (index (index .NetworkSettings.Ports "8080/tcp") 0).HostPort }}' oauth2-mock-oauth2-server-1
+    - `docker inspect -f '{{ (index (index .NetworkSettings.Ports "8080/tcp") 0).HostPort }}' oauth2-mock-oauth2-server-1`
 - Look at server logs for readiness/errors:
-    - docker logs -n 200 oauth2-mock-oauth2-server-1
+    - `docker logs -n 200 oauth2-mock-oauth2-server-1`
 - On Linux, ensure nothing else is bound to 8080 and that firewall/SELinux aren’t blocking:
-    - ss -ltnp | grep :8080
+    - `ss -ltnp | grep :8080`
 
 Notes
-- Discovery URL pattern is: http://localhost:8080/<realm>/.well-known/openid-configuration, where <realm> defaults to "default".
+- Discovery URL pattern is: `http://localhost:8080/<realm>/.well-known/openid-configuration`, where `<realm>` defaults to `default`.
 - You can change these with env vars when running the example:
-    - E2E_ISSUER_BASE (default: http://localhost:8080)
-    - E2E_REALM (default: default)
+    - `E2E_ISSUER_BASE` (default: http://localhost:8080)
+    - `E2E_REALM` (default: default)
 
 </details>