docs: cleanup

Author: neurosnap

posts/api-token.md

@@ -16,7 +16,7 @@ Common examples:
 ## Usage
 
 1. SSH into our [pico TUI](/ui#ssh-tui)
-2. Select "tokens" submenu
-3. Type <kbd>c</kbd> to generate a new token
-4. Give it a descriptive name
-5. Copy the generated token string to where you want to use it
+1. Select "tokens" submenu
+1. Type <kbd>c</kbd> to generate a new token
+1. Give it a descriptive name
+1. Copy the generated token string to where you want to use it

posts/custom-domains.md

@@ -11,7 +11,7 @@ it works is you create two DNS records:
 1. A `CNAME` record to send the traffic to us (or an `A`/`AAAA` if you don't
    have
    [CNAME flattening](https://developers.cloudflare.com/dns/cname-flattening/))
-2. A corresponding `TXT` record which we check to determine what content to
+1. A corresponding `TXT` record which we check to determine what content to
    serve the user.
 
 The first time we receive traffic on the custom domain, a certificate will be

posts/pgs.md

@@ -309,7 +309,7 @@ erock-kittens
 We have a couple of special files, when uploaded, will change the behavior of
 your site.
 
-## _pgs_ignore
+## \_pgs_ignore
 
 You can upload any file you want to pages, with a few exceptions.
 
@@ -338,7 +338,7 @@ with any comment:
 > first so we recommend uploading it on its own and then upload the rest of your
 > site.
 
-## _redirects
+## \_redirects
 
 We support custom redirects and rewrites via a special file `_redirects`.
 
@@ -416,7 +416,7 @@ Here are some examples:
   If you’re working with proxies, we recommend only publishing HTTPS URLs for
   your visitors to use.
 
-## _headers
+## \_headers
 
 We support custom headers via a special file `_headers`.
 

posts/pipe.md

@@ -13,7 +13,7 @@ There can be many publishers and many subscribers on a topic. Further, both pub
 and sub will wait for at least one event to be sent or received on the topic.
 
 [pipe](https://pipe.pico.sh) is a simple and secure way of putting together
-composable directional streams of data, just like a *nix `|` operator!
+composable directional streams of data, just like a \*nix `|` operator!
 
 # Features
 
@@ -40,7 +40,7 @@ composable directional streams of data, just like a *nix `|` operator!
 
 # Examples
 
-For example, maybe you have a *nix pipe you're using on the command line like
+For example, maybe you have a \*nix pipe you're using on the command line like
 so:
 
 ```bash
@@ -143,7 +143,7 @@ Usage: sub <topic> [args...]
 Args:
   -a string
         Comma separated list of pico usernames or ssh-key fingerprints to allow access to a topic
-  -c    Don't send status messages
+  -c    Don\'t send status messages
   -k    Keep the subscription alive even after the publisher has died
   -p    Subscribe to a public topic
 ```
@@ -157,7 +157,7 @@ Args:
   -a string
         Comma separated list of pico usernames or ssh-key fingerprints to allow access to a topic
   -b    Block writes until a subscriber is available (default true)
-  -c    Don't send status messages
+  -c    Don\'t send status messages
   -e    Send an empty message to subs
   -p    Publish message to public topic
   -t duration
@@ -172,7 +172,7 @@ Usage: pipe <topic> [args...]
 Args:
   -a string
         Comma separated list of pico usernames or ssh-key fingerprints to allow access to a topic
-  -c    Don't send status messages
+  -c    Don\'t send status messages
   -p    Pipe to a public topic
   -r    Replay messages to the client that sent it
 ```

posts/prose.md

@@ -113,7 +113,7 @@ and try to upload them to prose, the second post will overwrite the first one.
 
 User can change the look-and-feel of their blog by uploading special files.
 
-## _readme.md
+## \_readme.md
 
 This file will allow users to add content above the blog post list, add links to
 their blog landing page, and change blog metadata.
@@ -179,10 +179,10 @@ This property changes the layout of the blog index page. The options are:
 ### `with_styles`
 
 This determines whether we load our default styles onto your blog or not. This
-allows for better customization in conjunction with [_styles.css](/#-stylescss)
+allows for better customization in conjunction with [\_styles.css](/#-stylescss)
 which is the user-defined CSS stylesheet that gets served.
 
-## _styles.css
+## \_styles.css
 
 This will allow users to change the look-and-feel of their blog. This file will
 be the final CSS loaded on the page so it will overwrite whatever styles have
@@ -212,15 +212,15 @@ a file called `barrel.md` then the body element will have:
 <body id="post" class="barrel"></body>
 ```
 
-## _footer.md
+## \_footer.md
 
 This file will be added to the end of every single blog post.
 
 There is nothing that differentiates itself from the rest of the post so it's up
 to you to style it. For convenience we added an `id` to the containing element
 `post-footer`.
 
-## _404.md
+## \_404.md
 
 This file will override the default 404 page when a post cannot be found.
 

posts/tuns.md

@@ -292,7 +292,7 @@ and a `tun` interface. To get started, you need to follow a few steps:
    socat -v PIPE udp-recvfrom:5553,fork
    ```
 
-2. SSH into tuns requesting a `tun` interface with the information of where the
+1. SSH into tuns requesting a `tun` interface with the information of where the
    service is running. This needs to be done as root. Replace
    `local-ip-of-machines-main-interface` with the ip address of the main
    interface for proper routing.
@@ -302,14 +302,14 @@ and a `tun` interface. To get started, you need to follow a few steps:
      udp-forward=10000:local-ip-of-machines-main-interface:5553
    ```
 
-3. Bring the tunnel interface up and assign an ip that is link local (also as
+1. Bring the tunnel interface up and assign an ip that is link local (also as
    root):
 
    ```bash
    ip link set tun0 up; ip r a 10.1.0.1 dev tun0
    ```
 
-4. Start a udp client to tuns.sh:10000. Here's one with netcat:
+1. Start a udp client to tuns.sh:10000. Here's one with netcat:
 
    ```bash
    nc -u tuns.sh 10000
@@ -330,7 +330,7 @@ make this work! The `SRC` interface `MAC` is `00:00:00:00:00:01`, while the
    socat -v PIPE udp-recvfrom:5553,fork
    ```
 
-2. SSH into tuns requesting a `tap` interface with the information of where the
+1. SSH into tuns requesting a `tap` interface with the information of where the
    service is running. This needs to be done as root. Replace
    `local-ip-of-machines-main-interface` with the ip address of the main
    interface for proper routing.
@@ -340,7 +340,7 @@ make this work! The `SRC` interface `MAC` is `00:00:00:00:00:01`, while the
      udp-forward=10000:local-ip-of-machines-main-interface:5553
    ```
 
-3. Bring the tunnel interface up and assign an ip that is link local (also as
+1. Bring the tunnel interface up and assign an ip that is link local (also as
    root). You need to set the ARP entry and interface `MAC` as well:
 
    ```bash
@@ -350,7 +350,7 @@ make this work! The `SRC` interface `MAC` is `00:00:00:00:00:01`, while the
    ip neigh add 10.1.0.1 lladdr 00:00:00:00:00:01 dev tap0 nud permanent
    ```
 
-4. Start a udp client to tuns.sh:10000. Here's one with netcat:
+1. Start a udp client to tuns.sh:10000. Here's one with netcat:
 
    ```bash
    nc -u tuns.sh 10000