formatting

Author: gcstr

docs/introduction/getting_started.md

@@ -20,7 +20,7 @@ Before you begin, make sure you have the following installed:
 
 On macOS or Linux, you can install Dockform using [Homebrew](https://brew.sh/):
 
-```sh [terminal ~vscode-icons:file-type-shell~]
+```sh [shell ~vscode-icons:file-type-shell~]
 $ brew tap gcstr/dockform
 $ brew install dockform
 ```
@@ -36,7 +36,7 @@ Download the binary for your platform, extract it, and place it somewhere in you
 
 Dockform includes a convenience command to scaffold a new project:
 
-```sh [terminal ~vscode-icons:file-type-shell~]
+```sh [shell ~vscode-icons:file-type-shell~]
 dockform init
 ```
 

docs/manifest/secrets.md

@@ -22,7 +22,7 @@ You need both **SOPS** and **Age** installed:
 
 Generate a new Age key pair and store it locally:
 
-```sh [terminal ~vscode-icons:file-type-shell~]
+```sh [shell ~vscode-icons:file-type-shell~]
 $ age-keygen -o ~/.config/sops/age/keys.txt
 ```
 
@@ -40,7 +40,7 @@ sops:
 
 Use Dockform to scaffold a new secrets file:
 
-```sh [terminal ~vscode-icons:file-type-shell~]
+```sh [shell ~vscode-icons:file-type-shell~]
 $ dockform secrets create secrets.env
 # A template encrypted dotenv file will be created
 ```
@@ -49,7 +49,7 @@ $ dockform secrets create secrets.env
 
 Open the file securely with your `$EDITOR`. Dockform decrypts it on the fly and re-encrypts on save:
 
-```sh [terminal ~vscode-icons:file-type-shell~]
+```sh [shell ~vscode-icons:file-type-shell~]
 $ dockform secrets edit secrets.env
 ```
 

docs/more/debugging.md

@@ -12,14 +12,14 @@ The renderer opens a fullscreen pager in TTY (press `q` to quit, `↑`/`↓`/`Pg
 
 Render the manifest with environment variable interpolation applied. Any missing `${VAR}` will be replaced with an empty string and reported as a warning.
 
-```bash
+```bash [shell ~vscode-icons:file-type-shell~]
 # From the directory containing your manifest
-dockform manifest render
+$ dockform manifest render
 
 # Or specify a path (file or directory); discovery order:
 # dockform.yml, dockform.yaml, Dockform.yml, Dockform.yaml
-dockform manifest render -c ./path/to/dir
-dockform manifest render -c ./path/to/dockform.yml
+$ dockform manifest render -c ./path/to/dir
+$ dockform manifest render -c ./path/to/dockform.yml
 ```
 
 - **TTY behavior**: Opens a fullscreen pager with highlighted YAML and line numbers.
@@ -28,12 +28,12 @@ dockform manifest render -c ./path/to/dockform.yml
 
 Examples:
 
-```bash
+```bash [shell ~vscode-icons:file-type-shell~]
 # Pipe the interpolated manifest to a file
-dockform manifest render -c ./infra > manifest.debug.yml
+$ dockform manifest render -c ./infra > manifest.debug.yml
 
 # Grep for resolved values
-dockform manifest render | grep identifier
+$ dockform manifest render | grep identifier
 ```
 
 ## Compose rendering
@@ -49,18 +49,18 @@ Render the fully-resolved Docker Compose configuration for a specific applicatio
 
 Usage:
 
-```bash
+```bash [shell ~vscode-icons:file-type-shell~]
 # Render an app by name (from your manifest’s applications map)
-dockform compose render myapp
+$ dockform compose render myapp
 
 # Optional flags
-dockform compose render myapp --mask full            # default
-dockform compose render myapp --mask partial         # keep 2+2 chars
-dockform compose render myapp --mask preserve-length # same length as original
-dockform compose render myapp --show-secrets         # OPT-IN: disable masking
+$ dockform compose render myapp --mask full            # default
+$ dockform compose render myapp --mask partial         # keep 2+2 chars
+$ dockform compose render myapp --mask preserve-length # same length as original
+$ dockform compose render myapp --show-secrets         # OPT-IN: disable masking
 
 # Respect a non-default manifest path
-dockform compose render myapp -c ./envs/prod
+$ dockform compose render myapp -c ./envs/prod
 ```
 
 - **TTY behavior**: Opens a fullscreen pager with highlighted YAML, line numbers, and a relative file title (e.g., File: apps/web/docker-compose.yml). If multiple files are merged, the title shows a suffix like (+N).
@@ -69,15 +69,15 @@ dockform compose render myapp -c ./envs/prod
 
 Examples:
 
-```bash
+```bash [shell ~vscode-icons:file-type-shell~]
 # Save the fully-resolved compose to inspect diffs
-dockform compose render api > compose.debug.yml
+$ dockform compose render api > compose.debug.yml
 
 # Preview with partial masking
-dockform compose render api --mask partial | less -R
+$ dockform compose render api --mask partial | less -R
 
 # Force showing secrets (e.g., in CI logs avoid using this)
-dockform compose render api --show-secrets
+$ dockform compose render api --show-secrets
 ```
 
 :::: warning