chore: aligned docs to the template file for articles

knowledge base/fstab.md

@@ -1,5 +1,10 @@
 # Fstab
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```txt
@@ -19,5 +24,10 @@ UUID=41c22818-fbad-4da6-8196-c816df0b7aa8  /disk2p2  ext3  defaults,errors=remou
 - [Mount a disk partition using LABEL]
 - [Mount a disk partition using UUID]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [mount a disk partition using label]: https://www.cyberciti.biz/faq/rhel-centos-debian-fedora-mount-partition-label/
 [mount a disk partition using uuid]: https://www.cyberciti.biz/faq/linux-finding-using-uuids-to-update-fstab/

knowledge base/fwupd.md

@@ -1,5 +1,10 @@
 # Fwupd
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -28,5 +33,10 @@ fwupdmgr clear-history
 - [Website]
 - [GitHub] page
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [github]: https://github.com/fwupd/fwupd
 [website]: https://fwupd.org/

knowledge base/ghostscript.md

@@ -1,5 +1,11 @@
 # Ghostscript
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Reduce the size of PDF files](#reduce-the-size-of-pdf-files)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -39,4 +45,9 @@ Use one of the following options for the value of `-dPDFSETTINGS`:
 
 - [Reducing PDF File size]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [reducing pdf file size]: https://superuser.com/questions/293856/reducing-pdf-file-size#1217306

knowledge base/git.md

@@ -1,5 +1,7 @@
 # Git
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
 1. [Authentication](#authentication)
 1. [Configuration](#configuration)
@@ -924,6 +926,8 @@ git -c http.sslVerify=false …
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [How to get the current branch name in Git?]
 - [Git Submodules: Adding, Using, Removing, Updating]
 - [How to add and update git submodules]
@@ -954,7 +958,11 @@ git -c http.sslVerify=false …
 - [1 minute coding tip: git diff-words to see diffs on a per-word basis instead of per line]
 - [Dress up your git diffs with word-level highlights]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [docs]: https://git-scm.com/docs/git
 [getting git on a server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Getting-Git-on-a-Server
 [git-config reference]: https://git-scm.com/docs/git-config
@@ -962,7 +970,10 @@ git -c http.sslVerify=false …
 [setting up the server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Setting-Up-the-Server
 [tagging]: https://git-scm.com/book/en/v2/Git-Basics-Tagging
 
-<!-- external references -->
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Others -->
 [1 minute coding tip: git diff-words to see diffs on a per-word basis instead of per line]: https://www.youtube.com/watch?v=gDkvLxbA5ZE
 [10 git tips we can't live without]: https://opensource.com/article/22/4/git-tips
 [able to push to all git remotes with the one command?]: https://stackoverflow.com/questions/5785549/able-to-push-to-all-git-remotes-with-the-one-command

knowledge base/helios4.md

@@ -2,16 +2,12 @@
 
 ## Table of contents <!-- omit in toc -->
 
-1. [TL;DR](#tldr)
 1. [OS installation](#os-installation)
 1. [First boot](#first-boot)
 1. [Connect to the Helios4 using a serial console](#connect-to-the-helios4-using-a-serial-console)
    1. [First login](#first-login)
 1. [Configuration](#configuration)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
-
-## TL;DR
 
 ## OS installation
 
@@ -85,18 +81,17 @@ sudo armbian-config
 
 - [Armbian]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [download page]: https://wiki.kobol.io/download/#helios4
 [installation guide]: https://wiki.kobol.io/helios4/install/
 [tested microsd cards]: https://wiki.kobol.io/helios4/sdcard/#tested-microsd-card
 
-<!-- internal references -->
+<!-- Knowledge base -->
 [armbian]: armbian.md
-[further readings]: #further-readings
 
-<!-- external references -->
+<!-- Others -->
 [balenaetcher]: http://etcher.io/

knowledge base/homebrew.md

@@ -117,13 +117,19 @@ git branch -d ${formula_name}-${formula_version}
 - [manpage]
 - Homebrew [bundle]
 
-[bundle]: https://github.com/Homebrew/homebrew-bundle
-[manpage]: https://docs.brew.sh/Manpage
-
 ## Sources
 
 - [How to stop homebrew from upgrading itself on every run]
 - [macOS migrations with Brewfile]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
+[bundle]: https://github.com/Homebrew/homebrew-bundle
+[manpage]: https://docs.brew.sh/Manpage
+
+<!-- Others -->
 [how to stop homebrew from upgrading itself on every run]: https://superuser.com/questions/1209053/how-do-i-tell-homebrew-to-stop-running-brew-update-every-time-i-want-to-install/1209068#1209068
 [macos migrations with brewfile]: https://openfolder.sh/macos-migrations-with-brewfile

knowledge base/http response status codes.md

@@ -5,5 +5,10 @@
 - [MDN]
 - [http.cat]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [mdn]: https://developer.mozilla.org/nl/docs/Web/HTTP/Status
 [http.cat]: https://http.cat/

knowledge base/imagemagick.md

@@ -51,18 +51,17 @@ All the references in the [further readings] section, plus the following:
 - [ImageMagick compare without generating diff image]
 
 <!--
-  references
+  References
   -->
 
-<!-- upstream -->
+<!-- Upstream -->
 [image similarity comparison]: https://imagemagick.org/script/compare.php
 [website]: https://imagemagick.org
 
-<!-- article sections -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- knowledge base -->
+<!-- Others -->
-<!-- others -->
 [cheat.sh/compare]: https://cheat.sh/compare
 [cheat.sh/convert]: https://cheat.sh/convert
 [converting multiple images into a pdf file]: https://legacy.imagemagick.org/discourse-server/viewtopic.php?p=144157&sid=e7706233f81874af86ffbbf3e57b1e76#p144157

knowledge base/immutable operating systems.md

@@ -5,6 +5,10 @@
 - [Fedora Silverblue]
 - OpenSUSE [MicroOS]
 
-<!-- internal references -->
+<!--
+  References
+  -->
+
+<!-- Knowledge base -->
 [fedora silverblue]: fedora%20silverblue.md
 [microos]: microos.md

knowledge base/insomnia.md

@@ -1,4 +1,11 @@
-# Insomnia <!-- omit in toc -->
+# Insomnia
+
+## Table of contents <!-- omit in toc -->
+
+1. [Troubleshooting](#troubleshooting)
+   1. [Manually install plugins](#manually-install-plugins)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
 
 ## Troubleshooting
 
@@ -19,15 +26,24 @@
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [NPM install module in current directory]
 
-<!-- internal knowledge base -->
+<!--
-[postman]: postman.md
+  References
+  -->
 
-<!-- projects' references -->
+<!-- Upstream -->
 [documentation]: https://docs.insomnia.rest/
 [inso cli]: https://docs.insomnia.rest/inso-cli
 [website]: https://insomnia.rest/
 
-<!-- others -->
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Knowledge base -->
+[postman]: postman.md
+
+<!-- Others -->
 [npm install module in current directory]: https://stackoverflow.com/questions/14032160/npm-install-module-in-current-directory#45660836

knowledge base/internet protocol.md

@@ -6,7 +6,6 @@
    1. [IPv4 ranges](#ipv4-ranges)
    1. [IPv6 ranges](#ipv6-ranges)
       1. [IPv6 additional ranges](#ipv6-additional-ranges)
-1. [Further readings](#further-readings)
 1. [Sources](#sources)
 
 ## Bogon addresses
@@ -83,18 +82,13 @@ These ranges aren't officially IPv6 bogon ranges - they're IPv6 representations
 | 2001:0:f000::/36      | Teredo bogon (240.0.0.0/4)        |
 | 2001:0:ffff:ffff::/64 | Teredo bogon (255.255.255.255/32) |
 
-## Further readings
-
 ## Sources
 
 - [Bogon IP addresses]
 
-All the references in the [further readings] section, plus the following:
+<!--
+  References
+  -->
 
-<!-- upstream -->
+<!-- Others -->
-
-<!-- internal references -->
-[further readings]: #further-readings
-
-<!-- external references -->
 [bogon ip addresses]: https://ipinfo.io/bogon

knowledge base/iperf.md

@@ -1,5 +1,12 @@
 # Iperf
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
+## TL;DR
+
 ```sh
 # Server side.
 iperf3 -s
@@ -14,4 +21,9 @@ iperf3 -c 'iperf.server.ip' -p '7575'
 
 - [How to use iPerf3 to test network bandwidth]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [how to use iperf3 to test network bandwidth]: https://www.techtarget.com/searchnetworking/tip/How-to-use-iPerf-to-measure-throughput

knowledge base/iptab.md

@@ -25,13 +25,11 @@ All the references in the [further readings] section, plus the following:
 - [6 more terminal commands you should know]
 
 <!--
-  references
+  References
   -->
 
-<!-- upstream -->
+<!-- In-article sections -->
-<!-- article sections -->
 [further readings]: #further-readings
 
-<!-- knowledge base -->
+<!-- Others -->
-<!-- others -->
 [6 more terminal commands you should know]: https://betterprogramming.pub/6-more-terminal-commands-you-should-know-3606cecdf8b6

knowledge base/iw.md

@@ -1,5 +1,10 @@
 # Iw
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -20,4 +25,9 @@ iw dev wlp link
 
 - [cheat.sh]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [cheat.sh]: https://cheat.sh/iw

knowledge base/jdupes.md

@@ -1,5 +1,12 @@
 # Jdupes
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Options](#options)
+1. [Filter format](#filter-format)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -40,7 +47,6 @@ Short | Long                     | Description
 `-X`  | `--ext-filter=spec:info` | exclude/filter files based on specified criteria; see the [filter format](#filter-format) section
 `-Z`  | `--soft-abort`           | if the user aborts the program (as with CTRL-C), act on the matches that were found before the abort was received; the default behavior without `-Z` is to abort without taking any actions
 
-
 ## Filter format
 
 `jdupes -X filter[:value][size_suffix]`
@@ -68,4 +74,9 @@ Supported filters:
 
 - Jdupes' [github] page
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [github]: https://github.com/jbruchon/jdupes

knowledge base/jira.md

@@ -1,7 +1,14 @@
 # Jira
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
+## TL;DR
+
 ```sh
-# create a ticket
+# Create a ticket from the CLI.
 curl https://${COMPANY}.atlassian.net/rest/api/2/issue \
   -D - \
   -u ${USER_EMAIL}:${API_TOKEN} \
@@ -25,4 +32,9 @@ curl https://${COMPANY}.atlassian.net/rest/api/2/issue \
 
 - [Creating JIRA issue using curl from command line]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [creating jira issue using curl from command line]: https://stackoverflow.com/questions/31052721/creating-jira-issue-using-curl-from-command-line#31052990

knowledge base/jmespath.md

@@ -1,5 +1,10 @@
 # JMESPath
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -23,5 +28,10 @@ az disk-encryption-set show --ids 'id' \
 
 - [Website]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [specifications]: https://jmespath.org/specification.html
 [website]: https://jmespath.org/

knowledge base/jot.md

@@ -43,14 +43,12 @@ All the references in the [further readings] section, plus the following:
 - [6 more terminal commands you should know]
 
 <!--
-  references
+  References
   -->
 
-<!-- upstream -->
+<!-- In-article sections -->
-<!-- article sections -->
 [further readings]: #further-readings
 
-<!-- knowledge base -->
+<!-- Others -->
-<!-- others -->
 [6 more terminal commands you should know]: https://betterprogramming.pub/6-more-terminal-commands-you-should-know-3606cecdf8b6
 [man page]: https://manned.org/jot

knowledge base/jq.md

@@ -1,5 +1,11 @@
 # JQ
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -94,10 +100,20 @@ helm template chartName \
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Filter objects list with regex]
 - [Select multiple conditions]
 - [Change multiple values at once]
 
+<!--
+  References
+  -->
+
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Others -->
 [change multiple values at once]: https://stackoverflow.com/questions/47355901/jq-change-multiple-values#47357956
 [filter objects list with regex]: https://til.hashrocket.com/posts/uv0bjiokwk-use-jq-to-filter-objects-list-with-regex
 [select multiple conditions]: https://stackoverflow.com/questions/33057420/jq-select-multiple-conditions#33059058

knowledge base/jsonpath.md

@@ -1,5 +1,10 @@
 # JSONPath
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -14,5 +19,10 @@ kubectl get serviceaccounts \
 - [JSONPath Syntax]
 - [Live editor]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [jsonpath syntax]: https://support.smartbear.com/alertsite/docs/monitors/api/endpoint/jsonpath.html
 [live editor]: https://json8.github.io/patch/demos/apply/

knowledge base/kde.md

@@ -1,5 +1,12 @@
 # KDE
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Prioritize a WiFi network connection](#prioritize-a-wifi-network-connection)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -25,6 +32,16 @@ Plasma-nm lets you change a network's priority specifying a number in the networ
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Gsettings-like tools for KDE]
 
+<!--
+  References
+  -->
+
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Others -->
 [gsettings-like tools for kde]: https://askubuntu.com/questions/839647/gsettings-like-tools-for-kde

knowledge base/keybase.md

@@ -1,5 +1,15 @@
 # Keybase
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Service execution](#service-execution)
+1. [Import an existing repository in Keybase](#import-an-existing-repository-in-keybase)
+1. [Run as root](#run-as-root)
+1. [Temporary devices](#temporary-devices)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -126,10 +136,22 @@ In addition, ephemeral keys are **purged entirely** when closing the oneshot ses
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Keybase LFS support]
 - [Keybase launches encrypted git]
 - [How to use Keybase to encrypt files on Linux]
 
-[how to use keybase to encrypt files on linux]: https://www.addictivetips.com/ubuntu-linux-tips/keybase-encrypt-files-linux/
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [keybase launches encrypted git]: https://keybase.io/blog/encrypted-git-for-everyone
 [keybase lfs support]: https://github.com/keybase/client/issues/8936
+
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Others -->
+[how to use keybase to encrypt files on linux]: https://www.addictivetips.com/ubuntu-linux-tips/keybase-encrypt-files-linux/

knowledge base/knockd.md

@@ -8,7 +8,6 @@ When the server detects a specific sequence of port-hits, it runs a command defi
 
 1. [TL;DR](#tldr)
 1. [Configuration](#configuration)
-1. [Further readings](#further-readings)
 1. [Sources](#sources)
 
 ## TL;DR
@@ -88,17 +87,17 @@ Sequences can also be defined in files.
 
 Check the [`knockd(1)`][knockd man page] man page for all the information.
 
-## Further readings
-
 ## Sources
 
 - [How to use port knocking to secure SSH service in Linux]
 - [Server][knockd man page]'s man page
 - [Client][knock man page]'s man page
 
-<!-- upstream -->
+<!--
-<!-- internal references -->
+  References
-<!-- external references -->
+  -->
+
+<!-- Others -->
 [how to use port knocking to secure ssh service in linux]: https://www.tecmint.com/port-knocking-to-secure-ssh/
 [knockd man page]: https://linux.die.net/man/1/knockd
 [knock man page]: https://linux.die.net/man/1/knock

knowledge base/lint markdown files.md

@@ -2,4 +2,9 @@
 
 See [mdl].
 
+<!--
+  References
+  -->
+
+<!-- Knowledge base -->
 [mdl]: mdl.md

knowledge base/linux kernel modules.md

@@ -4,7 +4,6 @@
 
 1. [TL;DR](#tldr)
 1. [Permanent modules configuration](#permanent-modules-configuration)
-1. [Further readings](#further-readings)
 1. [Sources](#sources)
 
 ## TL;DR
@@ -55,8 +54,6 @@ Write the options in a `.conf` file in `/etc/modprobe.d/`:
 options brcmfmac roamoff=1 feature_disable=0x82000
 ```
 
-## Further readings
-
 ## Sources
 
 All the references in the [further readings] section, plus the following:
@@ -64,12 +61,14 @@ All the references in the [further readings] section, plus the following:
 - The [Kernel module][arch wiki kernel module] page in the [Arch wiki]
 - The [Kernel modules][gentoo wiki kernel modules]
 
-<!-- upstream -->
+<!--
+  References
+  -->
 
-<!-- internal references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- external references -->
+<!-- Others -->
 [arch wiki]: https://wiki.archlinux.org
 [arch wiki kernel module]: https://wiki.archlinux.org/title/Kernel_module
 [gentoo wiki]: https://wiki.gentoo.org/wiki/Main_Page

knowledge base/list image tags from ghcr.io.md

@@ -22,8 +22,9 @@ $ curl https://ghcr.io/v2/jbruchon/jdupes/tags/list \
 
 - [How to check if a container image exists on GHCR?]
 
-<!-- upstream -->
+<!--
-<!-- internal references -->
+  References
+  -->
 
-<!-- external references -->
+<!-- Others -->
 [how to check if a container image exists on ghcr?]: https://github.com/orgs/community/discussions/26279#discussioncomment-3251171

knowledge base/lm-sensors.md

@@ -1,5 +1,10 @@
 # LM-sensors
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -28,6 +33,11 @@ sensors --fahrenheit
 - [archlinux wiki]
 - [How to Install lm Sensors on Linux]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [archlinux wiki]: https://wiki.archlinux.org/title/lm_sensors
 [cheat.sh]: https://cheat.sh/sensors
 [how to install lm sensors on linux]: https://linoxide.com/install-lm-sensors-linux/

knowledge base/lower the power consumption on linux.md

@@ -1,5 +1,12 @@
 # Lower the power consumption on Linux
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
+## TL;DR
+
 ```sh
 echo '0' > '/proc/sys/kernel/nmi_watchdog'
 echo 'med_power_with_dipm' > '/sys/class/scsi_host/host0/link_power_management_policy'
@@ -15,5 +22,9 @@ sudo sysctl vm.dirty_writeback_centisecs=6000
 
 - Arch Wiki's [power management][arch wiki power management] page
 
-<!-- -->
+<!--
+  References
+  -->
+
+<!-- Others -->
 [arch wiki power management]: https://wiki.archlinux.org/title/Power_management

knowledge base/lxc.md

@@ -1,5 +1,11 @@
 # Linux Container Runtime
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Create new containers as an unprivileged user](#create-new-containers-as-an-unprivileged-user)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -55,15 +61,10 @@ echo "vagrant veth lxcbr0 10" | sudo tee -a '/etc/lxc/lxc-usernet'
 - [Website]
 - [Getting started guide][getting started]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [getting started]: https://linuxcontainers.org/lxc/getting-started/
 [website]: https://linuxcontainers.org/
-
-<!-- internal references -->
-[further readings]: #further-readings
-
-<!-- external references -->

knowledge base/m365.md

@@ -6,7 +6,6 @@ CLI tool for Microsoft 365.
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -51,17 +50,17 @@ m365 logout
 - [node.js]
 - [`npm`][npm]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [github]: https://github.com/pnp/cli-microsoft365
 [website]: https://pnp.github.io/cli-microsoft365/
 
-<!-- internal references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
+
+<!-- Knowledge base -->
 [node.js]: node.js.md
 [npm]: npm.md
-
-<!-- external references -->

knowledge base/magisk.md

@@ -1,13 +1,15 @@
 # Magisk
 
-1. [TL;DR](#tldr)
+> Worked on:
-1. [Further readings](#further-readings)
-
-> This procedure worked for the following devices:
 >
 > - OnePlus One
 > - OnePlus 5
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 1. download and flash the os' recovery-flashable zip file
@@ -65,11 +67,13 @@ To flash the patched boot image from your computer with `adb` and `fastboot`:
 - [How to Install Magisk on your Android Phone]
 - [Magisk install]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
+[magisk install]: https://topjohnwu.github.io/Magisk/install.html
 [releases]: https://github.com/topjohnwu/Magisk/releases
 
-<!-- internal references -->
+<!-- Others -->
-
-<!-- external references -->
 [how to install magisk on your android phone]: https://www.xda-developers.com/how-to-install-magisk/
-[magisk install]: https://topjohnwu.github.io/Magisk/install.html

knowledge base/mount files as virtual file systems.md

@@ -1,5 +1,11 @@
 # Mount files as virtual file systems
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -27,11 +33,20 @@ Prefer `truncate` to `dd` to let the file expand dynamically and be resized (bot
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [How do I create a file and mount it as a filesystem?]
 
-<!-- -->
+<!--
+  References
+  -->
+
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Knowledge base -->
 [dd]: dd.md
 [truncate]: truncate.md
 
-<!-- -->
+<!-- Others -->
 [how do i create a file and mount it as a filesystem?]: https://askubuntu.com/questions/85977/how-do-i-create-a-file-and-mount-it-as-a-filesystem#1402052

knowledge base/mount.md

@@ -1,5 +1,10 @@
 # Mount
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -32,6 +37,11 @@ mount -t tmpfs tmpfs '/mount/point' -o 'size=2048m'
 - [Manually Mounting an SMB Share]
 - [Access denied by server while mounting NFS share]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [access denied by server while mounting nfs share]: https://www.thegeekdiary.com/mount-nfs-access-denied-by-server-while-mounting-how-to-resolve/
 [how to mount a .img file]: https://www.linuxquestions.org/questions/linux-general-1/how-to-mount-img-file-882386/#post4366162
 [manually mounting an smb share]: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/mounting_an_smb_share

knowledge base/multipass.md

@@ -1,5 +1,11 @@
 # Multipass
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -41,10 +47,19 @@ multipass purge
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Use Linux Virtual Machines with Multipass]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [website]: https://multipass.run/
 
-<!-- external references -->
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Others -->
 [use linux virtual machines with multipass]: https://medium.com/codex/use-linux-virtual-machines-with-multipass-4e2b620cc6

knowledge base/mysql.md

@@ -1,5 +1,10 @@
 # MySQL
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -36,6 +41,11 @@ grant ALL on db.* to 'username'@'127.0.0.1';
 - How to [show databases] in MySQL
 - [phpimap issue 1549]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [list tables]: https://alvinalexander.com/blog/post/mysql/list-tables-in-mysql-database/
 [show databases]: https://linuxize.com/post/how-to-show-databases-in-mysql/
 [phpimap issue 1549]: https://github.com/phpipam/phpipam/issues/1549

knowledge base/nc.md

@@ -10,6 +10,11 @@
 - `-w=SECS`: timeout for connects and final net reads, in seconds
 - `-z`: zero-I/O mode, exit once connected
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -34,6 +39,9 @@ nc -l 5666
 
 - [How To use Netcat to establish and test TCP and UDP connections]
 
-<!-- upstream -->
+<!--
+  References
+  -->
 
+<!-- Others -->
 [how to use netcat to establish and test tcp and udp connections]: https://www.digitalocean.com/community/tutorials/how-to-use-netcat-to-establish-and-test-tcp-and-udp-connections

knowledge base/needs-restarting.md

@@ -2,6 +2,11 @@
 
 `needs-restarting -r` returns 1 if a reboot is needed, and 0 if it is not.
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -38,4 +43,9 @@ Reboot is required to ensure that your system benefits from these updates.
 
 - [Automatic Reboot on Kernel Update]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [automatic reboot on kernel update]: https://access.redhat.com/discussions/3106621#comment-1196821

knowledge base/netrc.md

@@ -7,6 +7,11 @@ either by the user executing the command or by the root user.
 If the .netrc file contains a login password, the file's permissions must be set
 to `600` (read and write by its owner only).
 
+## Table of contents <!-- omit in toc -->
+
+1. [Format](#format)
+1. [Further readings](#further-readings)
+
 ## Format
 
 The file can contain the following entries separated by spaces, tabs, or new
@@ -46,4 +51,9 @@ password bluebonnet
 
 - [netrc]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [netrc]: https://everything.curl.dev/usingcurl/netrc

knowledge base/netselect-apt.md

@@ -34,11 +34,15 @@ All the references in the [further readings] section, plus the following:
 
 - [How to find the fastest mirror in Debian and derivatives]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [man page]: https://manpages.debian.org/testing/netselect-apt/netselect-apt.1.en.html
 
-<!-- internal references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- external references -->
+<!-- Others -->
 [how to find the fastest mirror in debian and derivatives]: https://www.unixmen.com/find-fastest-mirror-debian-derivatives/

knowledge base/network manager.md

@@ -1,5 +1,10 @@
 # Network Manager
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -16,6 +21,15 @@ nmtui
 
 ## Sources
 
-- [nm-settings]
+- [Website]
+- [NM-settings]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
+[website]: https://networkmanager.dev/
+
+<!-- Others -->
 [nm-settings]: https://people.freedesktop.org/~lkundrak/nm-docs/nm-settings.html

knowledge base/newman.md

@@ -1,9 +1,11 @@
-# Newman <!-- omit in toc -->
+# Newman
 
 CLI Collection runner for Postman.
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
-2. [Further readings](#further-readings)
+1. [Further readings](#further-readings)
 
 ## TL;DR
 
@@ -16,8 +18,12 @@ brew install newman
 - [Postman]
 - [Running Collections on the command line with Newman]
 
-<!-- internal knowledge base -->
+<!--
+  References
+  -->
+
+<!-- Knowledge base -->
 [postman]: postman.md
 
-<!-- projects' references -->
+<!-- Upstream -->
 [running collections on the command line with newman]: https://learning.postman.com/docs/running-collections/using-newman-cli/command-line-integration-with-newman/

knowledge base/nextcloud.md

@@ -2,6 +2,13 @@
 
 Redis is recommended to prevent file locking problems.
 
+## Table of contents <!-- omit in toc -->
+
+1. [Containerized](#containerized)
+   1. [Official helm chart](#official-helm-chart)
+1. [Snappy](#snappy)
+1. [Further readings](#further-readings)
+
 ## Containerized
 
 Use environment variables to inform Nextcloud about internal configuration:
@@ -85,10 +92,17 @@ To configure Nextcloud from `snap`:
 - The snap version's [README][snap readme]
 - [How to install and configure Nextcloud on Ubuntu 18.04]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [check if redis is used by nextcloud]: https://help.nextcloud.com/t/how-to-check-if-redis-is-used-in-nc/22268/2
 [docker image]: https://hub.docker.com/_/nextcloud/
 [docker readme]: https://github.com/docker-library/docs/blob/master/nextcloud/README.md
 [helm chart]: https://github.com/nextcloud/helm/tree/master/charts/nextcloud
-[how to install and configure nextcloud on ubuntu 18.04]: https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-nextcloud-on-ubuntu-18-04
 [snap readme]: https://github.com/nextcloud/nextcloud-snap
 [website]: https://nextcloud.com/
+
+<!-- Others -->
+[how to install and configure nextcloud on ubuntu 18.04]: https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-nextcloud-on-ubuntu-18-04

knowledge base/nmap.md

@@ -1,5 +1,10 @@
 # Nmap
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -18,5 +23,13 @@ nmap -O 192.168.0.1
 - [Cheatsheet]
 - [OS detection]
 
-[cheatsheet]: https://hackertarget.com/nmap-cheatsheet-a-quick-reference-guide/
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [os detection]: https://nmap.org/book/man-os-detection.html
+
+
+<!-- Others -->
+[cheatsheet]: https://hackertarget.com/nmap-cheatsheet-a-quick-reference-guide/

knowledge base/node.js.md

@@ -6,7 +6,6 @@ Open-source, cross-platform JavaScript runtime environment.
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -20,15 +19,12 @@ export NODE_EXTRA_CA_CERTS='path/to/trusted/ca/cert.pem'
 - [Website]
 - [`npm`][npm]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [website]: https://nodejs.org/en
 
-<!-- internal references -->
+<!-- Knowledge base -->
-[further readings]: #further-readings
 [npm]: npm.md
-
-<!-- external references -->

knowledge base/npm.md

@@ -4,7 +4,6 @@
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -28,15 +27,12 @@ npm uninstall '@pnp/cli-microsoft365'
 - Official [documentation]
 - [node.js]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [documentation]: https://docs.npmjs.com/cli/
 
-<!-- internal references -->
+<!-- Knowledge base -->
-[further readings]: #further-readings
 [node.js]: node.js.md
-
-<!-- external references -->

knowledge base/nvme-cli.md

@@ -1,5 +1,10 @@
 # Nvme-cli
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -17,4 +22,9 @@ sudo nvme smart-log /dev/nvme0
 
 - [How to check CPU temperature on Ubuntu Linux]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [how to check cpu temperature on ubuntu linux]: https://www.cyberciti.biz/faq/how-to-check-cpu-temperature-on-ubuntu-linux/

knowledge base/oci-cli.md

@@ -2,6 +2,8 @@
 
 Oracle Cloud Infrastructure CLI.
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
 1. [Configuration](#configuration)
 1. [Further readings](#further-readings)
@@ -63,7 +65,11 @@ oci compute instance list -c 'tenancy_id'
 - [SDK and CLI Configuration File]
 - [Required keys and OCIDs]
 
-<!-- oracle cloud's documentation -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [command line interface]: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm
 [required keys and ocids]: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm
 [sdk and cli configuration file]: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm

knowledge base/opencl.md

@@ -6,7 +6,6 @@ Open Computing Language is an open, royalty-free standard for cross-platform, pa
 
 1. [Implementations](#implementations)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## Implementations
 
@@ -16,15 +15,12 @@ Open Computing Language is an open, royalty-free standard for cross-platform, pa
 
 - [Website]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [website]: https://www.khronos.org/opencl/
 
-<!-- internal references -->
+<!-- In-article sections -->
-[further readings]: #further-readings
 [pocl]: pocl.md
-
-<!-- external references -->

knowledge base/openssl.md

@@ -207,12 +207,14 @@ All the references in the [further readings] section, plus the following:
 - [OpenSSL unable to verify the first certificate for Experian URL]
 - [Verify certificate chain with OpenSSL]
 
-<!-- upstream -->
+<!--
-<!-- in-article references -->
+  References
+  -->
+
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- internal references -->
+<!-- Others -->
-<!-- external references -->
 [check ssl certificate chain with openssl examples]: https://www.howtouselinux.com/post/certificate-chain
 [create a self signed certificate]: https://stackoverflow.com/questions/10175812/how-to-create-a-self-signed-certificate-with-openssl#10176685
 [display the contents of a ssl certificate]: https://support.qacafe.com/knowledge-base/how-do-i-display-the-contents-of-a-ssl-certificate/

knowledge base/opensuse linux.md

@@ -1,5 +1,15 @@
 # OpenSUSE
 
+## Table of contents <!-- omit in toc -->
+
+1. [Enable Bluetooth pairing on boot](#enable-bluetooth-pairing-on-boot)
+1. [Enable SSH access from outside after installation](#enable-ssh-access-from-outside-after-installation)
+1. [Raspberry Pi](#raspberry-pi)
+   1. [Firmware update from a running system](#firmware-update-from-a-running-system)
+1. [Rollback from a bootable snapshot](#rollback-from-a-bootable-snapshot)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## Enable Bluetooth pairing on boot
 
 1. enable the `bluetooth` service on boot
@@ -96,17 +106,25 @@ A snapshot of the file system status before the rollback is created, and the def
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [OpenSSH basics]
 - [Bluetooth on boot]
 - [Raspberry Pi4]
 
-<!-- further readings -->
+<!--
+  References
+  -->
 
+<!-- Upstream -->
+[openssh basics]: https://en.opensuse.org/SDB:OpenSSH_basics
+[raspberry pi4]: https://en.opensuse.org/openSUSE:Raspberry_Pi
+[system recovery and snapshot management with snapper]: https://documentation.suse.com/sles/12-SP4/html/SLES-all/cha-snapper.html
+
+<!-- Knowledge base -->
 [bluetooth]: bluetooth.md#bluetooth-devices-cannot-be-used-at-login
 [firewalld]: firewalld.md
 [systemd]: systemd.md
 
+<!-- Others -->
 [bluetooth on boot]: https://www.reddit.com/r/openSUSE/comments/eoozm2/comment/feetqpn/
-[openssh basics]: https://en.opensuse.org/SDB:OpenSSH_basics
-[raspberry pi4]: https://en.opensuse.org/openSUSE:Raspberry_Pi
-[system recovery and snapshot management with snapper]: https://documentation.suse.com/sles/12-SP4/html/SLES-all/cha-snapper.html

knowledge base/opkg.md

@@ -1,5 +1,10 @@
 # Opkg
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -42,4 +47,9 @@ opkg depends dropbear
 
 - [Opkg package manager]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [opkg package manager]: https://openwrt.org/docs/guide-user/additional-software/opkg

knowledge base/optimize battery on a linux system.md

@@ -1,9 +1,11 @@
 # Optimize battery on a linux system
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
-2. [Disable unused services](#disable-unused-services)
+1. [Disable unused services](#disable-unused-services)
-3. [Improve battery performance](#improve-battery-performance)
+1. [Improve battery performance](#improve-battery-performance)
-4. [Further readings](#further-readings)
+1. [Further readings](#further-readings)
 
 ## TL;DR
 
@@ -61,5 +63,10 @@ sudo 'powertop'
 - [laptop-mode-tools]
 - [laptop-mode-tools in the Arch Wiki]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [laptop-mode-tools]: https://www.unixmen.com/laptop-mode-tools-extend-laptop-battery-life/
 [laptop-mode-tools in the arch wiki]: https://wiki.archlinux.org/title/Laptop_Mode_Tools

knowledge base/oracle cloud.md

@@ -1,11 +1,13 @@
 # Oracle Cloud
 
+## Table of contents <!-- omit in toc -->
+
 1. [Concepts](#concepts)
    1. [Compartments](#compartments)
-   2. [Networking](#networking)
+   1. [Networking](#networking)
       1. [Access to the Internet](#access-to-the-internet)
-2. [Further readings](#further-readings)
+1. [Further readings](#further-readings)
-3. [Sources](#sources)
+1. [Sources](#sources)
 
 ## Concepts
 
@@ -29,20 +31,26 @@ Before deleting a compartment, all its resources must have been moved, deleted o
 
 ## Further readings
 
-- [oci-cli]
+- [`oci-cli`][oci-cli]
 - [Compute images]
 - [Connect to private compute instances using OCI Bastion Service]
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Required keys and OCIDs]
 
-<!-- oracle cloud's documentation -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [compute images]: https://docs.oracle.com/en-us/iaas/images/
 [required keys and ocids]: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm
 
-<!-- internal references -->
+<!-- In-article sections -->
-[oci-cli]: ./oci-cli.md
+[oci-cli]: oci-cli.md
 
-<!-- external references -->
+<!-- Others -->
 [connect to private compute instances using oci bastion service]: https://medium.com/@harjulthakkar/connect-to-private-compute-instance-using-oci-bastion-service-ca96a3ceea49

knowledge base/pacman.md

@@ -7,6 +7,11 @@ Useful options:
 - `--needed`
 - `--unneeded`
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -36,4 +41,9 @@ pacman --noconfirm \
 
 - [Prevent pacman from reinstalling packages that were already installed]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [Prevent pacman from reinstalling packages that were already installed]: https://superuser.com/questions/568967/prevent-pacman-from-reinstalling-packages-that-were-already-installed#568983

knowledge base/pamac.md

@@ -1,5 +1,10 @@
 # Pamac
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -14,4 +19,9 @@ pamac remove --no-save --orphans --unneeded
 
 - Manjaro's [Wiki]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [wiki]: https://wiki.manjaro.org/index.php/Pamac

knowledge base/parallel.md

@@ -1,5 +1,10 @@
 # GNU Parallel
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -49,7 +54,13 @@ parallel --tag "magick compare -metric NCC -quiet {} NULL: 2>&1; echo" \
 - GNU Parallel's [tutorial]
 - [Obtaining exit status values from GNU parallel]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [man page]: https://www.gnu.org/software/parallel/man.html
 [tutorial]: https://www.gnu.org/software/parallel/parallel_tutorial.html
 
+<!-- Others -->
 [obtaining exit status values from gnu parallel]: https://stackoverflow.com/questions/6310181/obtaining-exit-status-values-from-gnu-parallel#6789085

knowledge base/pdfgrep.md

@@ -1 +1,3 @@
 # PDFGrep
+
+TODO

knowledge base/pdftk.md

@@ -1,5 +1,12 @@
 # PDFtk
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Combine multiple files](#combine-multiple-files)
+1. [Rotate a file](#rotate-a-file)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -43,5 +50,10 @@ where:
 - [Combine multiple PDF files with PDFTK]
 - [Lossless rotation of PDF files with ImageMagick]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [combine multiple pdf files with pdftk]: https://www.maketecheasier.com/combine-multiple-pdf-files-with-pdftk/
 [lossless rotation of pdf files with imagemagick]: https://stackoverflow.com/questions/38281526/lossless-rotation-of-pdf-files-with-imagemagick/51859078#51859078

knowledge base/pdfunite.md

@@ -7,7 +7,6 @@ None of the files in input can be encrypted.
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -20,14 +19,9 @@ pdfunite 'page-1.pdf' … 'page-N.pdf' 'output.pdf'
 
 - [Website]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [website]: https://poppler.freedesktop.org/
-
-<!-- internal references -->
-[further readings]: #further-readings
-
-<!-- external references -->

knowledge base/pi-hole.md

@@ -1,5 +1,10 @@
 # Pi-hole
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -17,15 +22,19 @@ stat /etc/pihole/gravity.db
 
 - [Website]
 - [Github]
-- The [pihole] command
+- [`pihole`][pihole] the command
 - [Run Pi-hole as a container with Podman on openSUSE]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [github]: https://github.com/pi-hole/pi-hole
 [website]: https://pi-hole.net/
 
-<!-- internal references -->
+<!-- In-article sections -->
 [pihole]: pihole.md
 
-<!-- external references -->
+<!-- Others -->
 [run pi-hole as a container with podman on opensuse]: https://www.suse.com/c/pihole-podman-opensuse/

knowledge base/pihole.md

@@ -1,5 +1,10 @@
 # Pihole
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -40,10 +45,12 @@ pihole -a -t 'path/to/backup/file.tar.gz'
 - [Pi-hole]
 - [The pihole command]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [the pihole command]: https://docs.pi-hole.net/core/pihole-command/
 
-<!-- internal references -->
+<!-- In-article sections -->
 [pi-hole]: pi-hole.md
-
-<!-- external references -->

knowledge base/ping.md

@@ -1,5 +1,10 @@
 # Ping
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -11,7 +16,9 @@ ping -i 120 -a 'ip-address'
 
 - [18 selected super-useful Linux one-liners]
 
-<!-- upstream -->
+<!--
-<!-- internal references -->
+  References
-<!-- external references -->
+  -->
+
+<!-- Others -->
 [18 selected super-useful linux one-liners]: https://medium.com/codex/18-selected-super-useful-linux-one-liners-398ba6d20f8c

knowledge base/pip.md

@@ -3,8 +3,14 @@
 Package installer for Python.
 
 1. [TL;DR](#tldr)
-2. [Configuration](#configuration)
+1. [Configuration](#configuration)
-3. [Further readings](#further-readings)
+1. [Further readings](#further-readings)
+
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Configuration](#configuration)
+1. [Further readings](#further-readings)
 
 ## TL;DR
 
@@ -54,4 +60,9 @@ Latter files override values from previous files, i.e. the global timeout specif
 
 - [Configuration]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [configuration]: https://pip.pypa.io/en/stable/topics/configuration/

knowledge base/pkexec.md

@@ -2,6 +2,11 @@
 
 Allows an _authorized_ user to execute a command as another user. If a username is not specified, the command will be executed as `root`.
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -12,4 +17,9 @@ pkexec systemctl hibernate
 
 - [Man page]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [man page]: https://linux.die.net/man/1/pkexec

knowledge base/pkgutil.md

@@ -6,6 +6,11 @@ Query and manipulate Mac OS X Installer packages and receipts.
 
 Options are processed first, and affect the operation of all commands. Multiple commands are performed sequentially in the given order.
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -30,4 +35,9 @@ pkgutil --file-info Bitwarden.app/Contents/MacOS/Bitwarden
 
 - [cheat.sh]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [cheat.sh]: https://cheat.sh/pkgutil

knowledge base/pocl.md

@@ -15,13 +15,12 @@ PoCL uses Clang as an OpenCL C frontend, and LLVM for kernel compiler implementa
 - [Website]
 - [OpenCL]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [website]: http://portablecl.org/
 
-<!-- in-article references -->
+<!-- Knowledge base -->
-[further readings]: #further-readings
-
-<!-- internal references -->
 [opencl]: opencl.md
-
-<!-- external references -->

knowledge base/portage.md

@@ -4,7 +4,6 @@
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -21,18 +20,18 @@ portageq envvar 'FEATURES' | xargs -n1
 ## Further readings
 
 - [Portage]
-- [/etc/portage]
+- [`/etc/portage`][/etc/portage]
+- [Gentoo Linux]
+- [Funtoo Linux]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [/etc/portage]: https://wiki.gentoo.org/wiki//etc/portage
 [portage]: https://wiki.gentoo.org/wiki/Portage
 
-<!-- in-article references -->
+<!-- Knowledge base -->
-[further readings]: #further-readings
+[gentoo linux]: gentoo%20linux.md
-
+[funtoo linux]: funtoo%20linux.md
-<!-- internal references -->
-<!-- external references -->

knowledge base/postgresql.md

@@ -29,12 +29,15 @@ All the references in the [further readings] section, plus the following:
 
 - [Connect to a PostgreSQL database]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [docker image]: https://github.com/docker-library/docs/blob/master/postgres/README.md
 
-<!-- in-article references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- internal references -->
+<!-- Others -->
-<!-- external references -->
 [connect to a postgresql database]: https://www.postgresqltutorial.com/connect-to-postgresql-database/

knowledge base/postman.md

@@ -2,6 +2,8 @@
 
 API platform for building and using APIs.
 
+## Table of contents <!-- omit in toc -->
+
 1. [Further readings](#further-readings)
 
 ## Further readings
@@ -11,10 +13,14 @@ API platform for building and using APIs.
 - [Insomnia], an alternative to Postman
 - [Newman], CLI Collection runner for Postman
 
-<!-- internal knowledge base -->
+<!--
+  References
+  -->
+
+<!-- Knowledge base -->
 [insomnia]: insomnia.md
 [newman]: newman.md
 
-<!-- projects' references -->
+<!-- Upstream -->
 [documentation]: https://learning.postman.com/docs
 [website]: https://www.postman.com/

knowledge base/powershell.md

@@ -4,6 +4,12 @@
 1. [Further readings](#further-readings)
 1. [Sources](#sources)
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```ps1
@@ -95,10 +101,14 @@ kubectl get nodes -o json `
 - [Multiple -and -or in PowerShell Where-Object statement]
 - [Get started with OpenSSH for Windows]
 
-<!-- microsoft's references -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [get started with openssh for windows]: https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse?tabs=powershell
 
-<!-- external references -->
+<!-- Others -->
 [how to print environment variables to the console in powershell?]: https://stackoverflow.com/questions/50861082/how-to-print-environment-variables-to-the-console-in-powershell#50861113
 [json file to table]: https://stackoverflow.com/questions/31415158/powershell-json-file-to-table#31415897
 [multiline commands]: https://shellgeek.com/powershell-multiline-command/

knowledge base/pre-commit.md

@@ -1,5 +1,12 @@
 # Pre-commit
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Troubleshooting](#troubleshooting)
+   1. [Some files are skipped during a run](#some-files-are-skipped-during-a-run)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -62,7 +69,11 @@ Check they are tracked (have been `add`ed to the repository).
 - Pre-commit's [website]
 - List of [supported hooks]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
+[file types by extension]: https://github.com/pre-commit/identify/blob/main/identify/extensions.py
 [supported hooks]: https://pre-commit.com/hooks.html
 [website]: https://pre-commit.com
-
-[file types by extension]: https://github.com/pre-commit/identify/blob/main/identify/extensions.py

knowledge base/print a compressed stream to stdout.md

@@ -1,5 +1,12 @@
 # Print a compressed stream to stdout
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
+## TL;DR
+
 ```sh
 cat file.zip | zcat
 cat file.zip | busybox unzip -p -
@@ -11,4 +18,9 @@ curl 'https://example.com/some.zip' | bsdtar -xOf -
 
 - [Unzip from stdin to stdout]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [unzip from stdin to stdout]: https://serverfault.com/questions/735882/unzip-from-stdin-to-stdout-funzip-python

knowledge base/python.md

@@ -1,5 +1,7 @@
 # Python
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
 1. [Dictionaries](#dictionaries)
 1. [F-strings](#f-strings)
@@ -201,17 +203,21 @@ See [concurrent execution] for more information.
 - [Logging library]
 - [Subprocess library]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [concurrent execution]: https://docs.python.org/3/library/concurrency.html
 [dictionaries]: https://docs.python.org/3/tutorial/datastructures.html#dictionaries
 [logging howto]: https://docs.python.org/3/howto/logging.html
 [logging library]: https://docs.python.org/3/library/logging.html
 [subprocess library]: https://docs.python.org/3/library/subprocess.html
 
-<!-- internal references -->
+<!-- In-article sections -->
-[pip]: ./pip.md
+[pip]: pip.md
 
-<!-- external references -->
+<!-- Others -->
 [*args and **kwargs in python]: https://www.geeksforgeeks.org/args-kwargs-python/
 [10 Python One-Liners for Dictionaries]: https://medium.com/codex/10-python-one-liners-for-dictionaries-d58754386a1d
 [an intro to threading in python]: https://realpython.com/intro-to-python-threading/

knowledge base/raspberry pi imager.md

@@ -29,11 +29,13 @@ All the references in the [further readings] section, plus the following:
 
 - [Raspberry Pi Imager Now Comes With Advanced Options]
 
-<!-- upstream -->
+<!--
+  References
+  -->
 
-<!-- internal references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 [raspberry pi os]: raspberry%20pi%20os.md
 
-<!-- external references -->
+<!-- Others -->
 [raspberry pi imager now comes with advanced options]: https://www.tomshardware.com/news/raspberry-pi-imager-now-comes-with-advanced-options

knowledge base/raspberry pi os.md

@@ -418,10 +418,10 @@ All the references in the [further readings] section, plus the following:
 - [Mirrors]
 
 <!--
-  references
+  References
   -->
 
-<!-- upstream -->
+<!-- Upstream -->
 [/boot/config.txt]: https://www.raspberrypi.org/documentation/configuration/config-txt/README.md
 [configuration]: https://www.raspberrypi.com/documentation/computers/configuration.html
 [mirrors]: https://www.raspbian.org/RaspbianMirrors
@@ -429,14 +429,14 @@ All the references in the [further readings] section, plus the following:
 [repositories]: https://www.raspbian.org/RaspbianRepository
 [vcgencmd]: https://www.raspberrypi.com/documentation/computers/os.html#vcgencmd
 
-<!-- article sections -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- knowledge base -->
+<!-- Knowledge base -->
 [k3s]: kubernetes/k3s.md
 [rfkill]: rfkill.md
 
-<!-- others -->
+<!-- Others -->
 [country code search]: https://www.iso.org/obp/ui/#search/code/
 [disabling bluetooth on raspberry pi]: https://di-marco.net/blog/it/2020-04-18-tips-disabling_bluetooth_on_raspberry_pi/
 [ghollingworth/overlayfs]: https://github.com/ghollingworth/overlayfs

knowledge base/redis-cli.md

@@ -40,17 +40,21 @@ redis-cli … 'MONITOR'
 
 ## Sources
 
-- [cheat.sh]
-
 All the references in the [further readings] section, plus the following:
 
-<!-- upstream -->
+- [cheat.sh]
+
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [documentation]: https://redis.io/docs/
 [website]: https://redis.io/
 
-<!-- in-article references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- internal references -->
+<!-- In-article sections -->
-<!-- external references -->
+<!-- Others -->
 [cheat.sh]: https://cheat.sh/redis-cli

knowledge base/reload a user's group assignments without logging out.md

@@ -1,5 +1,10 @@
 # Reload a user's group assignments without logging out
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -10,4 +15,9 @@ exec su -l $USER
 
 - [Reload a Linux user's group assignments without logging out]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [reload a linux user's group assignments without logging out]: https://superuser.com/questions/272061/reload-a-linux-users-group-assignments-without-logging-out#609141

knowledge base/rename.md

@@ -2,6 +2,11 @@
 
 > **Note:** this page refers to the command from the `util-linux` package on Linux or Homebrew's `rename` package.
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -17,6 +22,10 @@ rename -n 's/^What.*(\d{4}-\d{2}-\d{2}) at (\d{2}\.\d{2}.\d{2}\..*)/$1 $2/' *
 - [cheat.sh]
 - [How to use the rename command on Linux]
 
-<!-- external references -->
+<!--
+  References
+  -->
+
+<!-- Others -->
 [cheat.sh]: https://cheat.sh/rename
 [How to Use the rename Command on Linux]: https://www.howtogeek.com/423214/how-to-use-the-rename-command-on-linux/

knowledge base/renew the ip address lease.md

@@ -1,5 +1,10 @@
 # Renew the IP address lease
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -14,10 +19,14 @@ sudo dhclient -r eth0
 ## Further readings
 
 - [Force the DHCP client to renew the IP address in Linux]
-- [dhclient]
+- [`dhclient`][dhclient]
 
-<!-- internal references -->
+<!--
+  References
+  -->
+
+<!-- In-article sections -->
 [dhclient]: dhclient.md
 
-<!-- external references -->
+<!-- Others -->
 [force the dhcp client to renew the ip address in linux]: https://www.cyberciti.biz/faq/howto-linux-renew-dhcp-client-ip-address/

knowledge base/replicated.md

@@ -1,5 +1,10 @@
 # Replicated
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -15,12 +20,12 @@ replicated admin --tty=0 retrieve-iact
 - [replicatedctl]
 - [Configuration file example]
 
-## Sources
+<!--
+  References
+  -->
 
-<!-- upstream -->
+<!-- Knowledge base -->
-
-<!-- internal references -->
 [replicatedctl]: replicatedctl.md
-[configuration file example]: ../examples/terraform%20enterprise/replicated.settings.json
 
-<!-- external references -->
+<!-- Files -->
+[configuration file example]: ../examples/terraform%20enterprise/replicated.settings.json

knowledge base/replicatedctl.md

@@ -1,5 +1,10 @@
 # replicatedctl
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -38,5 +43,9 @@ replicatedctl app apply-config
 
 - [Command reference]
 
-<!-- upstream -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [command reference]: https://help.replicated.com/api/replicatedctl/

knowledge base/resize an image from cli.md

@@ -9,8 +9,13 @@ magick convert -adaptive-resize '50%' 'in.jpg' 'out.jpg'
 ls -1 | xargs -I{} magick convert -adaptive-resize '50%' {} {}_scaled.jpg
 ```
 
-Further readings
+## Further readings
 
 - [imagemagick]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [imagemagick]: imagemagick.md

knowledge base/retrieve disk information.md

@@ -1,5 +1,10 @@
 # Retrieve disk information
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -14,4 +19,9 @@ ls /dev/disk/by-id
 
 - [Retrieve disk info from the command line]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [retrieve disk info from the command line]: https://www.linuxjournal.com/content/tech-tip-retrieve-disk-info-command-line

knowledge base/rfkill.md

@@ -1,7 +1,9 @@
 # rfkill
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
-2. [Sources](#sources)
+1. [Sources](#sources)
 
 ## TL;DR
 
@@ -22,7 +24,9 @@ rfkill unblock 'id'
 
 - [How to disable your Raspberry Pi's Wi-Fi]
 
-<!-- upstream -->
+<!--
-<!-- internal references -->
+  References
-<!-- external references -->
+  -->
+
+<!-- Others -->
 [how to disable your raspberry pi's wi-fi]: https://pimylifeup.com/raspberry-pi-disable-wifi/

knowledge base/rm.md

@@ -1,5 +1,10 @@
 # Rm
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -12,7 +17,9 @@ rm !(*.xls|*.slsx|*.csv)
 
 - [18 selected super-useful Linux one-liners]
 
-<!-- upstream -->
+<!--
-<!-- internal references -->
+  References
-<!-- external references -->
+  -->
+
+<!-- Others -->
 [18 selected super-useful linux one-liners]: https://medium.com/codex/18-selected-super-useful-linux-one-liners-398ba6d20f8c

knowledge base/rotate a pdf file.md

@@ -1,7 +1,10 @@
 # Rotate a PDF file
 
-## Further readings
+See [`pdftk`][pdftk].
 
-- [pdftk]
+<!--
+  References
+  -->
 
+<!-- Knowledge base -->
 [pdftk]: pdftk.md#rotate-a-file

knowledge base/rpm-ostree.md

@@ -5,6 +5,12 @@
 | Kinoite    | Fedora KDE         |
 | Silverblue | Fedora Workstation |
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Package layering](#package-layering)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 Changes to the base layer are executed in a new bootable filesystem root. This means that the system must be rebooted after a package has been layered.
@@ -60,5 +66,10 @@ If you don't want to reboot your system to switch to the new deployment, you can
 [flatpak]: flatpak.md
 [toolbox]: toolbox.md
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [fedora silverblue user guide]: https://docs.fedoraproject.org/en-US/fedora-silverblue/
 [rpm-ostree]: https://coreos.github.io/rpm-ostree/

knowledge base/rpm.md

@@ -1,5 +1,10 @@
 # The RPM package manager
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -17,4 +22,9 @@ rpm --query --file /usr/bin/file
 
 - [How can I list all files which have been installed by an ZYpp/Zypper package?]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [how can i list all files which have been installed by an zypp/zypper package?]: https://unix.stackexchange.com/questions/162092/how-can-i-list-all-files-which-have-been-installed-by-an-zypp-zypper-package#239944

knowledge base/rsync.md

@@ -1,5 +1,7 @@
 # rsync
 
+## Table of contents <!-- omit in toc -->
+
 1. [TL;DR](#tldr)
 1. [Explored options](#explored-options)
 1. [Sources](#sources)
@@ -130,8 +132,10 @@ parallel -q \
 - [cheat.sh]
 - [Showing total progress in rsync: is it possible?]
 
-<!-- -->
+<!--
-[cheat.sh]: https://cheat.sh/rsync
+  References
+  -->
 
-<!-- -->
+<!-- Others -->
+[cheat.sh]: https://cheat.sh/rsync
 [showing total progress in rsync: is it possible?]: https://serverfault.com/questions/219013/showing-total-progress-in-rsync-is-it-possible#441724

knowledge base/saltstack.md

@@ -15,7 +15,6 @@
 1. [Batch size](#batch-size)
 1. [Terminology](#terminology)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
 
 ## TL;DR
 
@@ -224,17 +223,12 @@ salt --batch-size 10 '*' state.apply
 - [Targeting]
 - [Top files][top]
 
-## Sources
+<!--
+  References
+  -->
 
-All the references in the [further readings] section, plus the following:
+<!-- Upstream -->
-
-<!-- upstream -->
 [installation]: https://docs.saltstack.com/en/getstarted/fundamentals/install.html
 [states]: https://docs.saltstack.com/en/getstarted/fundamentals/states.html
 [targeting]: https://docs.saltstack.com/en/getstarted/fundamentals/targeting.html
 [top]: https://docs.saltstack.com/en/getstarted/fundamentals/top.html
-
-<!-- internal references -->
-[further readings]: #further-readings
-
-<!-- external references -->

knowledge base/save the current picture of the day.md

@@ -8,4 +8,9 @@ Check the contents of `$HOME/.cache/plasma_engine_potd`.
 
 - [Reddit]
 
+<!--
+  References
+  -->
+
+<!-- Others -->
 [reddit]: https://www.reddit.com/r/kde/comments/9qve2q/save_the_picture_of_the_day/e8c5kev

knowledge base/scan a document on linux.md

@@ -48,14 +48,18 @@ All the references in the [further readings] section, plus the following:
 
 - [SANE frontends]
 
-<!-- sane references -->
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [sane frontends]: http://www.sane-project.org/sane-frontends.html
 [sane]: https://wiki.archlinux.org/title/SANE
 
-<!-- internal references -->
+<!-- In-article sections -->
 [further readings]: #further-readings
 
-<!-- external references -->
+<!-- Others -->
 [gscan2pdf]: https://en.wikipedia.org/wiki/Scanner_Access_Now_Easy#gscan2pdf
 [ocrfeeder]: https://en.wikipedia.org/wiki/OCRFeeder
 [paperwork]: https://openpaper.work/

knowledge base/script.md

@@ -42,15 +42,13 @@ All the references in the [further readings] section, plus the following:
 - [cheat.sh]
 
 <!--
-  references
+  References
   -->
 
-<!-- upstream -->
+<!-- In-article sections -->
-<!-- article sections -->
 [further readings]: #further-readings
 
-<!-- knowledge base -->
+<!-- Others -->
-<!-- others -->
 [6 more terminal commands you should know]: https://betterprogramming.pub/6-more-terminal-commands-you-should-know-3606cecdf8b6
 [cheat.sh]: https://cheat.sh/script
 [man]: https://manned.org/script

knowledge base/sddm.md

@@ -1,5 +1,10 @@
 # SDDM
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -11,6 +16,10 @@ sddm-greeter --test-mode --theme /usr/share/sddm/themes/breeze
 
 - The [SDDM article] on the [Archlinux wiki]
 
-[archlinux wiki]: https://wiki.archlinux.org
+<!--
+  References
+  -->
 
+<!-- Others -->
+[archlinux wiki]: https://wiki.archlinux.org
 [sddm article]: https://wiki.archlinux.org/index.php/SDDM

knowledge base/sed.md

@@ -1,5 +1,11 @@
 # SED
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Character classes and bracket expressions](#character-classes-and-bracket-expressions)
+1. [Further readings](#further-readings)
+
 ## TL;DR
 
 ```sh
@@ -37,5 +43,12 @@ sed /etc/fstab \
 - [GNU SED Online Tester]
 - [Character Classes and Bracket Expressions]
 
+<!--
+  References
+  -->
+
+<!-- Upstream -->
 [character classes and bracket expressions]: https://www.gnu.org/software/sed/manual/html_node/Character-Classes-and-Bracket-Expressions.html
+
+<!-- Others -->
 [gnu sed online tester]: https://sed.js.org/