diff --git a/docs/README.md b/docs/README.md
index 50acdbcd..f6991ed3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -39,13 +39,13 @@ alphabetical list of the remaining files
 
 | what | why |
 | -- | -- |
-| biquad.html | bruteforce calibrator for the audio equalizer since im not that good at maths |
-| design.txt | initial brainstorming of the copyparty design, unmaintained, incorrect, sentimental value only |
-| hls.html | experimenting with hls playback using `hls.js`, works p well, almost became a thing |
-| music-analysis.sh | testing various bpm/key detection libraries before settling on the ones used in [`/bin/mtag/`](/bin/mtag/) |
-| notes.sh | notepad, just scraps really |
-| nuitka.txt | how to build a copyparty exe using nuitka (not maintained) |
-| pretend-youre-qnap.patch | simulate a NAS which keeps returning old cached data even though you just modified the file yourself |
-| tcp-debug.sh | looks like this was to debug stuck tcp connections? |
-| unirange.py | uhh |
-| up2k.txt | initial ideas for how up2k should work, another unmaintained sentimental-value-only thing |
+| [biquad.html](biquad.html) | bruteforce calibrator for the audio equalizer since im not that good at maths |
+| [design.txt](design.txt) | initial brainstorming of the copyparty design, unmaintained, incorrect, sentimental value only |
+| [hls.html](hls.html) | experimenting with hls playback using `hls.js`, works p well, almost became a thing |
+| [music-analysis.sh](music-analysis.sh) | testing various bpm/key detection libraries before settling on the ones used in [`/bin/mtag/`](/bin/mtag/) |
+| [notes.sh](notes.sh) | notepad, just scraps really |
+| [nuitka.txt](nuitka.txt) | how to build a copyparty exe using nuitka (not maintained) |
+| [pretend-youre-qnap.patch](pretend-youre-qnap.patch) | simulate a NAS which keeps returning old cached data even though you just modified the file yourself |
+| [tcp-debug.sh](tcp-debug.sh) | looks like this was to debug stuck tcp connections? |
+| [unirange.py](unirange.py) | uhh |
+| [up2k.txt](up2k.txt) | initial ideas for how up2k should work, another unmaintained sentimental-value-only thing |