Markdown lint considered dangerous

Author: mxcl

docs/README.md

@@ -8,11 +8,17 @@
 brew install pkgx || curl https://pkgx.sh | sh
 ```
 
-{% hint style='info' %} [Installation Guide](installing-pkgx.md) {% endhint %}
+```pwsh
+irm https://pkgx.sh | iex  # Windows
+```
+
+{% hint style='info' %}
+[Installation Guide](installing-pkgx.md)
+{% endhint %}
 
 ## Using `pkgx`
 
-- [Run Anything](running-anything.md)
+- [Run Anything](pkgx.md)
 - [Scripting](scripting.md)
 
 # The `pkgx` Ecosystem
@@ -26,22 +32,25 @@ used to build a whole ecosystem of tools. Here’s what we’ve built so far:
 and any toolset.
 
 {% hint style='info' %}
-[https://github.com/pkgxdev/dev](https://github.com/pkgxdev/dev) {% endhint %}
+[https://github.com/pkgxdev/dev](https://github.com/pkgxdev/dev)
+{% endhint %}
 
 ## `pkgm`
 
 `pkgm` installs `pkgx` packages to `/usr/local`.
 
 {% hint style='info' %}
-[https://github.com/pkgxdev/pkgm](https://github.com/pkgxdev/pkgm) {% endhint %}
+[https://github.com/pkgxdev/pkgm](https://github.com/pkgxdev/pkgm)
+{% endhint %}
 
 ## `mash`
 
 `mash` is a package manager for scripts that use `pkgx` to make the whole open
 source ecosystem available to them.
 
 {% hint style='info' %}
-[https://github.com/pkgxdev/mash](https://github.com/pkgxdev/mash) {% endhint %}
+[https://github.com/pkgxdev/mash](https://github.com/pkgxdev/mash)
+{% endhint %}
 
 ## `pkgo` (Package…GO!)
 
@@ -50,7 +59,8 @@ instructions that can be… tedious. `pkgo` makes using amazing tools like
 [“Stable Diffusion WebUI”] as easy as typing `pkgo` (thanks to `pkgx`).
 
 {% hint style='info' %}
-[https://github.com/pkgxdev/pkgo](https://github.com/pkgxdev/pkgo) {% endhint %}
+[https://github.com/pkgxdev/pkgo](https://github.com/pkgxdev/pkgo)
+{% endhint %}
 
 [“Stable Diffusion WebUI”]: https://github.com/AUTOMATIC1111/stable-diffusion-webui
 

docs/SUMMARY.md

@@ -10,9 +10,10 @@
 
 ## The `pkgx` Ecosystem
 
-- [`dev`](https://github.com/pkgxdev/dev)
 - [`pkgm`](https://github.com/pkgxdev/pkgm)
+- [`dev`](https://github.com/pkgxdev/dev)
 - [`mash`](https://github.com/pkgxdev/mash) ​
+- [`pkgo`](https://github.com/pkgxdev/pkgo)
 
 ## Appendix
 

docs/faq.md

@@ -7,8 +7,9 @@ Typically you want to upgrade `pkgx` so either:
 1. `brew upgrade pkgx`; or
 2. `curl -LSsf pkgx.sh | sh`
 
-> [!NOTE]
-> Yes. Our installer upgrades `pkgx` too.
+{% hint style='info' %}
+Yes. Our installer upgrades `pkgx` too.
+{% endhint %}
 
 ## How do I run the latest version of a specific pkg?
 
@@ -118,10 +119,11 @@ platforms is expertise. Will you help? [Let’s talk].
 
 You need to add to the [pantry](pantry.md).
 
-{% hint style="info" %} Eventually we will support describing how to build or
+{% hint style="info" %}
+Eventually we will support describing how to build or
 obtain distributables for your package via your repo so you can just add a
-`pkgx.yaml` and users can use pkgx to use your package automatically. {% endhint
-%}
+`pkgx.yaml` and users can use pkgx to use your package automatically.
+{% endhint %}
 
 ## How should I recommend people use my pkg with pkgx?
 

docs/installing-pkgx.md

@@ -27,8 +27,10 @@ irm https://pkgx.sh | iex
 # ^^ limited packages so far, list available programs with `pkgx -Q`
 ```
 
-{% hint style='info' %} Wanna read that script before you run it?
-[github.com/pkgxdev/setup/installer.sh][installer] {% endhint %}
+{% hint style='info' %}
+Wanna read that script before you run it?
+[github.com/pkgxdev/setup/installer.sh][installer]
+{% endhint %}
 
 ## Download Manually
 
@@ -76,8 +78,8 @@ RUN pkgx +node@16 npm start
 ```
 
 {% hint style='info' %}
-[hub.docker.com/r/pkgxdev/pkgx](https://hub.docker.com/r/pkgxdev/pkgx) {%
-endhint %}
+[hub.docker.com/r/pkgxdev/pkgx](https://hub.docker.com/r/pkgxdev/pkgx)
+{% endhint %}
 
 ## GitHub Actions
 
@@ -86,20 +88,25 @@ endhint %}
 ```
 
 {% hint style='info' %}
-[github.com/pkgxdev/setup](https://github.com/pkgxdev/setup) {% endhint %}
+[github.com/pkgxdev/setup](https://github.com/pkgxdev/setup)
+{% endhint %}
 
-{% hint style='success' %} `pkgx` makes it easy to consistently use the GNU or
+{% hint style='success' %}
+`pkgx` makes it easy to consistently use the GNU or
 BSD versions of core utilities across different platforms—handy for
-cross-platform CI/CD scripts. eg. `pkgx +gnu.org/coreutils ls` {% endhint %}
+cross-platform CI/CD scripts. eg. `pkgx +gnu.org/coreutils ls`
+{% endhint %}
 
 ## Arch Linux
 
 If you're on Arch Linux (or any of it's derivatives) you can also use the
 [`pkgx` AUR] (latest released version) or [`pkgx-git` AUR] (latest development
 version, might not be stable).
 
-{% hint style='warning' %} The AURs are community-maintained and might be
-out-of-date. Use them with caution. {% endhint %}
+{% hint style='warning' %}
+The AURs are community-maintained and might be
+out-of-date. Use them with caution.
+{% endhint %}
 
 [GitHub Releases]: https://github.com/pkgxdev/pkgx/releases
 [installer]: https://github.com/pkgxdev/setup/blob/main/installer.sh

docs/pkging/pantry-api.md

@@ -16,9 +16,11 @@ Visit [dist.pkgx.dev](https://dist.pkgx.dev) for an HTTP index.
 `versions.txt` files are newline separated, sorted lists of available versions
 for each type of distributable.
 
-{% hint style="warning" %} `dist.pkgx.dev/<PKG>/versions.txt` and the bottle
+{% hint style="warning" %}
+`dist.pkgx.dev/<PKG>/versions.txt` and the bottle
 `versions.txt` may not be the same. Always check the more specific
-`versions.txt`. {% endhint %}
+`versions.txt`.
+{% endhint %}
 
 ## The Pantry
 

docs/pkging/pantry.md

@@ -3,13 +3,16 @@
 There’s millions of open source projects and `pkgx` needs your help to package
 them up!
 
-{% hint style="success" %} Visit [github.com/pkgxdev/pantry] for the full
-documentation. {% endhint %}
+{% hint style="success" %}
+Visit [github.com/pkgxdev/pantry] for the full documentation.
+{% endhint %}
 
-{% hint style="info" %} Curious about a specific pkg? `pkgx bk edit deno` will
-open deno’s `package.yml` in your editor. {% endhint %}
+{% hint style="info" %}
+Curious about a specific pkg? `pkgx bk edit deno` will open deno’s
+`package.yml` in your editor.
+{% endhint %}
 
-# Packagers Who Care
+## Packagers Who Care
 
 You trust us to just work and make your workflows happen. We take this job
 seriously and we go the extra mile on a per-package basis, for example:

docs/scripting.md

@@ -16,10 +16,12 @@ $ ./my-script.py
 3.9.17
 ```
 
-{% hint style="info" %} Using `env` to invoke `pkgx` is typical for tools that
+{% hint style="info" %}
+Using `env` to invoke `pkgx` is typical for tools that
 have no POSIX location.
 
-The `-S` parameter is required to pass multiple arguments. {% endhint %}
+The `-S` parameter is required to pass multiple arguments.
+{% endhint %}
 
 ## Including Additional pkgs
 
@@ -33,7 +35,8 @@ script.
 Deno.dlopen("libssl.dylib")
 ```
 
-{% hint style="info" %} Robustness requires precisely specifying your
+{% hint style="info" %}
+Robustness requires precisely specifying your
 environment:
 
 ```sh