Make MarkDown easier to parse

Grzegorz Szymaszek
2024-11-03 10:26:47 +01:00
parent 4f5d678e43
commit 63e7e64ddb

@@ -1,20 +1,31 @@
# Use `$(...)` notation instead of legacy backticked `` `...` ``.
### Problematic code
```sh
echo "You are running on `uname`"
```
### Correct code
```sh
echo "You are running on $(uname)"
```
### Rationale
Backtick command substitution `` `...` `` is legacy syntax with several issues.
1. It has a series of undefined behaviors related to quoting in POSIX.
1. It imposes a custom escaping mode with surprising results.
1. It's exceptionally hard to nest.
`$(...)` command substitution has none of these problems, and is therefore strongly encouraged.
### Exceptions
None.
### Related resources:
* [BashFaq: Why is `$(...)` preferred over `` `...` `` (backticks)?](http://mywiki.wooledge.org/BashFAQ/082)