TOC and 'back to top' links added

Author: johnnyfivepi

README.md

@@ -19,6 +19,11 @@
 
 🧠 _This guide was featured by [Tailscale](https://tailscale.com) in their newsletter and on Twitter/X._
 
+<blockquote class="note" style="border-left:4px solid #c51a4a; background:#fafafa; padding:0.6rem 1rem;">
+🪄 <strong>Ready to dive in?</strong> Jump straight to the 
+<a href="#self-hosting-a-vpn-with-tailscale-on-a-raspberry-pi">Tailscale setup guide ↓</a>
+</blockquote>
+
 🔒 A beginner-friendly walkthrough for setting up a Raspberry Pi as a secure, self-hosted VPN exit node using [Tailscale](https://tailscale.com) — with clear command-line steps and privacy-focused configuration.
 
 📖 View this guide online: [johnnyfivepi.github.io/tailscale-on-raspberry-pi](https://johnnyfivepi.github.io/tailscale-on-raspberry-pi/)
@@ -164,8 +169,6 @@ This guide is licensed under the [Creative Commons Attribution 4.0 License](http
 
 Use it, share it, remix it — just link back here and give credit. ✌️
 
----
-
 _Made with curiosity, coffee, and command-line trial & error_ ☕🖥️
 
 ---
@@ -182,7 +185,7 @@ Do you have a spare Raspberry Pi lying around just waiting for a fun project? If
 
 ---
 
-### Table of Contents
+## Table of Contents
 
 - [Introduction](#introduction)
 - [Prerequisites](#prerequisites)
@@ -210,6 +213,8 @@ Tailscale creates a private network called a **tailnet**, built on top of WireGu
 
 **Note:** Going through this process yesterday was relatively quick, but I wanted to make sure I understood what I was doing, what I was observing, and what speed-bumps I might have been accidentally speeding over. While catching some air was fun for all but the metaphorical vehicle's suspension, we'll slow down a bit in this guide, taking it step by step, ensuring we understand the process, and troubleshooting any bumps along the way.
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Prerequisites
@@ -222,12 +227,18 @@ Before we dive into setting up Tailscale and our exit node on the Raspberry Pi,
 - **A Tailscale account**: We’ll need this to connect our Raspberry Pi and other devices to our private network. If you don’t already have an account, [you can sign up for free](https://tailscale.com/pricing?plan=personal)!
 - **A computer or device to interact with the Raspberry Pi**: You'll need to connect to your Pi via SSH or directly using a monitor and keyboard. I used the command line to SSH into my Raspberry Pi, as I don't have an extra keyboard, mouse, or display.
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Preparing your Raspberry Pi
 
 If you already know how to flash your microSD card with Raspberry Pi OS, you can skip ahead to the next section. For those of us who prefer a quick refresher or are new to this, let's go over how to flash our microSD card with a Raspberry Pi OS!
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
+---
+
 ### Flashing the microSD Card 
 
 1. **Download and install the Raspberry Pi Imager**:
@@ -254,7 +265,6 @@ If you already know how to flash your microSD card with Raspberry Pi OS, you can
    - c. In the **Services** tab:
        - Make sure to check **Enable SSH**.
        - Choose the option to **Use password authentication**.
-   
    - d. In the **Options** tab:
        - Select any of the options you'd like. I only checked **Eject media when finished**, but which options you choose or don't is completely up to you.
    - e. Click the **Save** button.
@@ -272,6 +282,10 @@ If you already know how to flash your microSD card with Raspberry Pi OS, you can
 
 With that, we’re ready to SSH into our Raspberry Pi and start setting up Tailscale!
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
+---
+
 ### Using SSH to connect to your Raspberry Pi
 
 1. **Find your Raspberry Pi's IP address**:
@@ -294,6 +308,8 @@ With that, we’re ready to SSH into our Raspberry Pi and start setting up Tails
 
    - After logging in, you’ll be at the Raspberry Pi’s command prompt, ready to run commands.
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Checking for Updates
@@ -352,6 +368,8 @@ Before moving forward, it’s a good practice to update our Raspberry Pi’s sof
 
 Now we're ready to start the fun part!
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Setting up Tailscale on Raspberry Pi
@@ -387,6 +405,8 @@ Now we're ready to start the fun part!
 
 **High five!** We've successfully installed and authenticated Tailscale on our Raspberry Pi, and located our Pi's IPv4 address! Another excuse to stand up, stretch our legs, and treat ourselves to some celebratory noms!
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Understanding Key Expiry
@@ -435,6 +455,8 @@ In the end, it's all about finding that sweet spot where security and convenienc
 
 [Learn more about key expiry directly from Tailscale](https://tailscale.com/kb/1028/key-expiry).
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Configuring the Raspberry Pi as an Exit Node
@@ -485,6 +507,8 @@ When you're ready, SSH into your Raspberry Pi and follow these steps:
 
 From the Tailscale app on our other devices, we can now use the Raspberry Pi as an exit node for secure traffic routing. Tailscale has us covered with step-by-step instructions on **[how to use an exit node](https://tailscale.com/kb/1408/quick-guide-exit-nodes#use-an-exit-node)** depending on the type of device.
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Troubleshooting
@@ -565,6 +589,8 @@ To enable **UDP GRO forwarding** permanently:
 
 Credit to [@brkdncr](https://github.com/brkdncr) for surfacing this tip and sharing a reproducible service example ([Issue #1](https://github.com/johnnyfivepi/tailscale-on-raspberry-pi/issues/1)).
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Additional notes
@@ -573,12 +599,16 @@ Credit to [@brkdncr](https://github.com/brkdncr) for surfacing this tip and shar
 - No logs are generated by Tailscale for your activity, thanks to the end-to-end encryption that comes with WireGuard. This makes it more secure and private by design.
 - I started this project not just as a technical challenge, but also to explore networking, privacy, and security as I work toward growing my tech skills.
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### Conclusion
 
 Self-hosting a VPN (and setting up an exit node) with Tailscale on a Raspberry Pi is not only fun but also a great way to improve your privacy and security while browsing the internet. If you're interested in building a similar setup or want to ask questions about the process as I experienced it, feel free to leave a comment or reach out!
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 **Maintainer note:** Want to edit or contribute to this guide?  
@@ -597,6 +627,8 @@ If this guide helped you set up your own Tailscale exit node, consider buying me
 <p align="center">
 <a href='https://ko-fi.com/A0A41O8776' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi3.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a></p>
 
+[↑ Back to top](#table-of-contents){: .back-to-top }
+
 ---
 
 ### License

docs/.jekyll-metadata

@@ -25,9 +25,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="theme-color" content="#157878">
     <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
-    <link rel="stylesheet" href="/assets/css/style.css?v=d5f139eb8f176587f80617439be596797a33067f">
+    <link rel="stylesheet" href="/assets/css/style.css?v=8a7aac46b70196361af40bea9236cc103e355c5e">
     <!-- Custom stylesheet link (make sure it's compiled from assets/css/style.scss) -->
-<link rel="stylesheet" href="/assets/css/style.css?v=d5f139eb8f176587f80617439be596797a33067f">
+<link rel="stylesheet" href="/assets/css/style.css?v=8a7aac46b70196361af40bea9236cc103e355c5e">
   </head>
   <body>
     <a id="skip-to-content" href="#content">Skip to the content.</a>
@@ -56,11 +56,16 @@ <h2 class="project-tagline">Step-by-step guide to setting up Tailscale and a sec
 <img src="https://img.shields.io/badge/last%20updated-November%202025-blueviolet" alt="Last Updated" /></p>
 
 <p align="center">
-  <img src="assets/images/social-card.png" alt="Tailscale on Raspberry Pi" width="80%" />
+  <img src="assets/images/social-card.png" alt="Tailscale on Raspberry Pi" width="100%" />
 </p>
 
 <p>🧠 <em>This guide was featured by <a href="https://tailscale.com">Tailscale</a> in their newsletter and on Twitter/X.</em></p>
 
+<blockquote class="note" style="border-left:4px solid #c51a4a; background:#fafafa; padding:0.6rem 1rem;">
+🪄 <strong>Ready to dive in?</strong> Jump straight to the 
+<a href="#self-hosting-a-vpn-with-tailscale-on-a-raspberry-pi">Tailscale setup guide ↓</a>
+</blockquote>
+
 <p>🔒 A beginner-friendly walkthrough for setting up a Raspberry Pi as a secure, self-hosted VPN exit node using <a href="https://tailscale.com">Tailscale</a> — with clear command-line steps and privacy-focused configuration.</p>
 
 <p>💡 You’re viewing the full online version of this guide, hosted via GitHub Pages. Follow along step-by-step or jump to a specific section using the table of contents.</p>
@@ -237,8 +242,6 @@ <h2 id="-license">📄 License</h2>
 
 <p>Use it, share it, remix it — just link back here and give credit. ✌️</p>
 
-<hr />
-
 <p><em>Made with curiosity, coffee, and command-line trial &amp; error</em> ☕🖥️</p>
 
 <hr />
@@ -255,7 +258,7 @@ <h3 id="purpose-of-this-guide">Purpose of this guide</h3>
 
 <hr />
 
-<h3 id="table-of-contents">Table of Contents</h3>
+<h2 id="table-of-contents">Table of Contents</h2>
 
 <ul>
   <li><a href="#introduction">Introduction</a></li>
@@ -289,6 +292,8 @@ <h3 id="introduction">Introduction</h3>
 
 <p><strong>Note:</strong> Going through this process yesterday was relatively quick, but I wanted to make sure I understood what I was doing, what I was observing, and what speed-bumps I might have been accidentally speeding over. While catching some air was fun for all but the metaphorical vehicle’s suspension, we’ll slow down a bit in this guide, taking it step by step, ensuring we understand the process, and troubleshooting any bumps along the way.</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="prerequisites">Prerequisites</h3>
@@ -303,12 +308,18 @@ <h3 id="prerequisites">Prerequisites</h3>
   <li><strong>A computer or device to interact with the Raspberry Pi</strong>: You’ll need to connect to your Pi via SSH or directly using a monitor and keyboard. I used the command line to SSH into my Raspberry Pi, as I don’t have an extra keyboard, mouse, or display.</li>
 </ul>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="preparing-your-raspberry-pi">Preparing your Raspberry Pi</h3>
 
 <p>If you already know how to flash your microSD card with Raspberry Pi OS, you can skip ahead to the next section. For those of us who prefer a quick refresher or are new to this, let’s go over how to flash our microSD card with a Raspberry Pi OS!</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
+<hr />
+
 <h3 id="flashing-the-microsd-card">Flashing the microSD Card</h3>
 
 <ol>
@@ -388,6 +399,10 @@ <h3 id="flashing-the-microsd-card">Flashing the microSD Card</h3>
 
 <p>With that, we’re ready to SSH into our Raspberry Pi and start setting up Tailscale!</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
+<hr />
+
 <h3 id="using-ssh-to-connect-to-your-raspberry-pi">Using SSH to connect to your Raspberry Pi</h3>
 
 <ol>
@@ -426,6 +441,8 @@ <h3 id="using-ssh-to-connect-to-your-raspberry-pi">Using SSH to connect to your
   </li>
 </ol>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="checking-for-updates">Checking for Updates</h3>
@@ -512,6 +529,8 @@ <h3 id="checking-for-updates">Checking for Updates</h3>
 
 <p>Now we’re ready to start the fun part!</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="setting-up-tailscale-on-raspberry-pi">Setting up Tailscale on Raspberry Pi</h3>
@@ -558,6 +577,8 @@ <h3 id="setting-up-tailscale-on-raspberry-pi">Setting up Tailscale on Raspberry
 
 <p><strong>High five!</strong> We’ve successfully installed and authenticated Tailscale on our Raspberry Pi, and located our Pi’s IPv4 address! Another excuse to stand up, stretch our legs, and treat ourselves to some celebratory noms!</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="understanding-key-expiry">Understanding Key Expiry</h3>
@@ -629,6 +650,8 @@ <h3 id="understanding-key-expiry">Understanding Key Expiry</h3>
 
 <p><a href="https://tailscale.com/kb/1028/key-expiry">Learn more about key expiry directly from Tailscale</a>.</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="configuring-the-raspberry-pi-as-an-exit-node">Configuring the Raspberry Pi as an Exit Node</h3>
@@ -690,6 +713,8 @@ <h3 id="configuring-the-raspberry-pi-as-an-exit-node">Configuring the Raspberry
 
 <p>From the Tailscale app on our other devices, we can now use the Raspberry Pi as an exit node for secure traffic routing. Tailscale has us covered with step-by-step instructions on <strong><a href="https://tailscale.com/kb/1408/quick-guide-exit-nodes#use-an-exit-node">how to use an exit node</a></strong> depending on the type of device.</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="troubleshooting">Troubleshooting</h3>
@@ -773,6 +798,8 @@ <h3 id="️-optional-improve-udp-forwarding-performance">⚙️ Optional: Improv
 
 <p>Credit to <a href="https://github.com/brkdncr">@brkdncr</a> for surfacing this tip and sharing a reproducible service example (<a href="https://github.com/johnnyfivepi/tailscale-on-raspberry-pi/issues/1">Issue #1</a>).</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="additional-notes">Additional notes</h3>
@@ -783,12 +810,16 @@ <h3 id="additional-notes">Additional notes</h3>
   <li>I started this project not just as a technical challenge, but also to explore networking, privacy, and security as I work toward growing my tech skills.</li>
 </ul>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="conclusion">Conclusion</h3>
 
 <p>Self-hosting a VPN (and setting up an exit node) with Tailscale on a Raspberry Pi is not only fun but also a great way to improve your privacy and security while browsing the internet. If you’re interested in building a similar setup or want to ask questions about the process as I experienced it, feel free to leave a comment or reach out.</p>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <p><strong>Maintainer note:</strong> Want to edit or contribute to this guide?<br />
@@ -818,6 +849,8 @@ <h3 id="support-this-project">Support this project</h3>
   });
 </script>
 
+<p><a href="#table-of-contents" class="back-to-top">↑ Back to top</a></p>
+
 <hr />
 
 <h3 id="license">License</h3>