README: Tidied up code blocks and bare URLs.

Author: Adambean

README.md

@@ -69,7 +69,7 @@ Default: *false*
 
 #### winCompatibilityMode *(bool|null)*
 
-In some Active Directory instances when "user_dn" is empty (for example when the whole AD is searched for users), LDAP queries fail with the message "ldap_search(): Search: Operations error.". This is further described in https://stackoverflow.com/questions/17742751/ldap-operations-error. The fix described there is applied when **winCompatibilityMode** is set to *true*. Since this has only been tested on one instance, it is recommended to leave this option at *false* and only activate it if you experience the error described above.
+In some Active Directory instances when "user_dn" is empty (for example when the whole AD is searched for users), LDAP queries fail with the message "ldap_search(): Search: Operations error.". This is further described in <https://stackoverflow.com/questions/17742751/ldap-operations-error>. The fix described there is applied when **winCompatibilityMode** is set to *true*. Since this has only been tested on one instance, it is recommended to leave this option at *false* and only activate it if you experience the error described above.
 
 Default: *false*
 
@@ -235,7 +235,7 @@ This varies not only according to which directory software you're using, but als
 
 This must be defined as an array even if you have only 1 user. Be sure to quote user names that have spaces. For example:
 
-```
+```yaml
 userNamesToIgnore:
     - "nobody"
     - "Administrator"
@@ -258,7 +258,7 @@ This varies not only according to which directory software you're using, but als
 
 This must be defined as an array even if you have only 1 group. Be sure to quote group names that have spaces. For example:
 
-```
+```yaml
 groupNamesToIgnore:
     - "Managed Service Accounts"
     - "Marketing Staff"
@@ -311,7 +311,7 @@ This varies not only according to which directory software you're using, but als
 
 This must be defined as an array even if you have only 1 group. Be sure to quote group names that have spaces. For example:
 
-```
+```yaml
 groupNamesOfAdministrators:
     - "Domain Admins"
     - "Enterprise Admins"
@@ -330,7 +330,7 @@ This varies not only according to which directory software you're using, but als
 
 This must be defined as an array even if you have only 1 group. Be sure to quote group names that have spaces. For example:
 
-```
+```yaml
 groupNamesOfExternal:
     - "Domain Guests"
     - "Clients"
@@ -360,7 +360,7 @@ Specify the LDAP server name used by this Gitlab instance. You can find this in
 
 **You may need to put "ldap" before this value!** This hasn't been tested across different installation types, but using the Omnibus package it appears if your "gitlab.rb" has the following...
 
-```
+```ruby
 gitlab_rails['ldap_servers'] = {
     'main' => {
         ...
@@ -374,22 +374,22 @@ gitlab_rails['ldap_servers'] = {
 
 Once you've configured this tool you can run it from a CLI using:
 
-    `php bin/console ldap:sync -d`
+$ php bin/console ldap:sync -d
 
 Depending on your system's PHP installation you may need to use `php-cli` instead of `php`. (This typically only occurs on WHM/cPanel based servers configured to host PHP via the fast process manager, PHP-FPM.)
 
 **The `-d` option is important for your first run.** This enables "dry run" mode, meaning no changes will be persisted to your Gitlab instances. After running this tool you should evaluate the changes that will be made based on the output, then run it again without the `-d` option to persist the changes.
 
 If you'd like to see more verbose output you can add up to 3 `-v` switches, for example:
 
-    `php bin/console ldap:sync -v`
-    `php bin/console ldap:sync -vv`
-    `php bin/console ldap:sync -vvv`
+$ php bin/console ldap:sync -v
+$ php bin/console ldap:sync -vv
+$ php bin/console ldap:sync -vvv
 
 If you'd like to only sync with a single Gitlab instance you can specify the name of it as per your configuration as an argument, for example:
 
-    `php bin/console ldap:sync athena`
-    `php bin/console ldap:sync demeter`
+$ php bin/console ldap:sync athena
+$ php bin/console ldap:sync demeter
 
 ## Built With
 
@@ -425,6 +425,6 @@ Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 
 You may obtain a copy of the License at
 
-    http://www.apache.org/licenses/LICENSE-2.0
+<https://www.apache.org/licenses/LICENSE-2.0>
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the [License](LICENSE) for the specific language governing permissions and limitations under the License.