Some small improvements

docs/administration/email-setup.md

@@ -27,7 +27,7 @@ Note: For use in the official Gitea Docker image, please configure with the SMTP
 
 Note: For Internet-facing sites consult documentation of your MTA for instructions to send emails over TLS. Also set up SPF, DMARC, and DKIM DNS records to make emails sent be accepted as legitimate by various email providers.
 
-```ini
+```ini title="app.ini"
 [mailer]
 ENABLED       = true
 FROM          = gitea@mydomain.com
@@ -40,7 +40,7 @@ SENDMAIL_ARGS = "--" ; most "sendmail" programs take options, "--" will prevent
 
 Directly use SMTP server as relay. This option is useful if you don't want to set up MTA on your instance but you have an account at email provider.
 
-```ini
+```ini title="app.ini"
 [mailer]
 ENABLED        = true
 FROM           = gitea@mydomain.com
@@ -70,7 +70,7 @@ Note that Implicit TLS is recommended by [RFC8314](https://tools.ietf.org/html/r
 
 The following configuration should work with GMail's SMTP server:
 
-```ini
+```ini title="app.ini"
 [mailer]
 ENABLED        = true
 HOST           = smtp.gmail.com:465 ; Remove this line for Gitea >= 1.18.0

docs/installation/database-preparation.md

@@ -35,7 +35,7 @@ Note: All steps below requires that the database engine of your choice is instal
 
 2. On database instance, login to database console as root:
 
-    ```
+    ```sh
     mysql -u root -p
     ```
 

docs/installation/from-binary.md

@@ -30,7 +30,9 @@ You can find the file matching your platform from the [downloads page](https://d
 
 **For Windows**, you will likely want `windows-4.0-amd64`. It's for all modern versions of Windows, but there is also a `386` platform available designed for older, 32-bit versions of Windows.
 
-*Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.*
+:::info
+There is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.
+:::
 
 **For macOS**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel.
 
@@ -40,7 +42,7 @@ You can find the file matching your platform from the [downloads page](https://d
 
 Copy the commands below and replace the URL within the one you wish to download.
 
-```sh
+```shell
 wget -O gitea https://dl.gitea.com/gitea/@version@/gitea-@version@-linux-amd64
 chmod +x gitea
 ```

docs/installation/windows-service.md

@@ -20,7 +20,7 @@ menu:
 
 The following changes are made in C:\gitea\custom\conf\app.ini:
 
-```
+```ini title="app.ini"
 RUN_USER = COMPUTERNAME$
 ```
 
@@ -32,7 +32,7 @@ COMPUTERNAME is whatever the response is from `echo %COMPUTERNAME%` on the comma
 
 If you use SQLite3, change the `PATH` to include the full path:
 
-```
+```ini title="app.ini"
 [database]
 PATH     = c:/gitea/data/gitea.db
 ```
@@ -42,7 +42,7 @@ PATH     = c:/gitea/data/gitea.db
 To register Gitea as a Windows service, open a command prompt (cmd) as an Administrator,
 then run the following command:
 
-```
+```sh
 sc.exe create gitea start= auto binPath= "\"C:\gitea\gitea.exe\" web --config \"C:\gitea\custom\conf\app.ini\""
 ```
 
@@ -57,7 +57,7 @@ that was configured).
 It was observed that on loaded systems during boot Gitea service may fail to start with timeout records in Windows Event Log.
 In that case change startup type to `Automatic-Delayed`. This can be done during service creation, or by running config command
 
-```
+```sh
 sc.exe config gitea start= delayed-auto
 ```
 
@@ -65,7 +65,7 @@ sc.exe config gitea start= delayed-auto
 
 To add a startup dependency to the Gitea Windows service (eg Mysql, Mariadb), as an Administrator, then run the following command:
 
-```
+```sh
 sc.exe config gitea depend= mariadb
 ```
 
@@ -75,6 +75,6 @@ This will ensure that when the Windows machine restarts, the automatic starting
 
 To unregister Gitea as a Windows service, open a command prompt (cmd) as an Administrator and run:
 
-```
+```sh
 sc.exe delete gitea
 ```

docs/installation/with-docker.md

@@ -269,7 +269,9 @@ files; for named volumes, this is done through another container or by direct ac
 
 ## Upgrading
 
-:exclamation::exclamation: **Make sure you have volumed data to somewhere outside Docker container** :exclamation::exclamation:
+:::warning
+Make sure you have volumed data to somewhere outside Docker container
+:::
 
 To upgrade your installation to the latest release:
 
@@ -296,7 +298,7 @@ or in a `.env` file in the same directory as `docker-compose.yml`.
 The settings can be also set or overridden with the content of a file by defining an environment variable of the form:
 `GITEA__section_name__KEY_NAME__FILE` that points to a file.
 
-```bash
+```yaml
 ...
 services:
   server: