doc(fix): Satisfied MarkdownLint

Author: T145

.markdownlint.json

@@ -0,0 +1,17 @@
+{
+  "MD004": false,
+  "MD007": {
+    "indent": 2
+  },
+  "MD013": {
+    "line_length": 400
+  },
+  "MD026": {
+    "punctuation": ".,;:!。，；:"
+  },
+  "MD029": false,
+  "MD033": false,
+  "MD036": false,
+  "MD041": false,
+  "blank_lines": false
+}

LICENSE.md renamed to LICENSE.txt

@@ -1,10 +1,3 @@
-# Table of contents
-
-- [Black Mirror](#black-mirror)
-  - [On Spyware/Stalkerware](#on-spywarestalkerware)
-  - [On Propaganda](#on-propaganda)
-  - [On Social Media](#on-social-media)
-
 # Black Mirror
 
 The primary goals of this project are as follows:
@@ -31,6 +24,13 @@ The real power behind the freedom of speech is the ability to hear many opinions
 “Before you become too entranced with gorgeous gadgets and mesmerizing video displays, let me remind you that information is not knowledge, knowledge is not wisdom, and wisdom is not foresight. Each grows out of the other, and we need them all.”\
 ― *Arthur C. Clarke*
 
+## Table of contents
+
+- [Black Mirror](#black-mirror)
+  - [On Spyware/Stalkerware](#on-spywarestalkerware)
+  - [On Propaganda](#on-propaganda)
+  - [On Social Media](#on-social-media)
+
 ## On Spyware/Stalkerware
 
 <p align="center">
@@ -67,11 +67,15 @@ These services intrude on privacy, are usually malware, and compromise individua
 Internet "rabbit holes" and sites that primarily feature "knee-jerk contrarianism" do not promote sanity, and therefore are blocked.
 
 Regarding religion and sciences, `Black Mirror` takes an agnostic position on matters regarding how the universe began or where lacking sufficient historical data produces inconclusive results.
-This means a source will not be blocked specifically if it promotes athiesm or a popular religion.
-However, on matters where sufficient information is available to make an educated conclusion, opposing views (i.e. "knee-jerk contrarianism") featured on sites as a majority opinion (> 50%) will result in their host being blocked. To take this same reasoning into a non-religious context and provide a practical example, because we have conclusive evidence on the fact that the Earth is round from the time of Eratosthenes, sites that feature contradictory viewpoints as an opinion majority get blocked.
+This means a source will not be specifically blocked for promoting a popular viewpoint, such as athiesm, a religion, alternative sciences, etc.
+However, on matters where sufficient information is available to make an educated conclusion,
+"knee-jerk contrarian" views featured on sites as a majority opinion (> 50%)
+will result in their host(s) being blocked. To take this same reasoning into a non-religious context
+and provide a practical example, because we have conclusive evidence on the fact that the Earth is round
+from the time of Eratosthenes, sites that feature contradictory viewpoints as an opinion majority get blocked.
 
 Regarding politics, `Black Mirror` takes a non-radical Libertarian perspective.
-A source will not be blocked specifically if it promotes a non-radical left or right political perspective.
+A source will not be specifically blocked for promoting a popular viewpoint, such as a non-radical left or right political perspective.
 Like dealings with religion, platforms that promote "knee-jerk contrarianism" or philosophy that significantly breaches individual safety as an opinion majority will be blocked.
 
 “True liberty consists only in the power of doing what we ought to will, and in not being constrained to do what we ought not to will.”\

MANIFESTO.md

@@ -216,7 +216,7 @@ Free thought exchange is encouraged, so feel free to open discussions about any
 
 ### 🧮 Checksum Evaluation
 
-```
+```bash
 cat black_domain.txt | sha256sum -c black_domain.checksums --status && echo $?
 ```
 
@@ -236,39 +236,39 @@ Provided below are some examples to fetch release artifacts leveraging the GitHu
 
 #### Get all build artifacts
 
-```
+```bash
 curl --proto '=https' --tlsv1.3 -H 'Accept: application/vnd.github.v3+json' -sSf https://api.github.com/repos/T145/black-mirror/releases/latest | jq -r '.assets[].browser_download_url'
 ```
 
 #### Get a build artifact & its checksum
 
-```
+```bash
 curl --proto '=https' --tlsv1.3 -H 'Accept: application/vnd.github.v3+json' -sSf https://api.github.com/repos/T145/black-mirror/releases/latest | jq -r '.assets[] | select(.name | startswith("black_domain")).browser_download_url'
 ```
 
 #### Get a single build artifact
 
-```
+```bash
 curl --proto '=https' --tlsv1.3 -H 'Accept: application/vnd.github.v3+json' -sSf https://api.github.com/repos/T145/black-mirror/releases/latest | jq -r '.assets[] | select(.name | startswith("black_domain")) | select(.name | endswith(".txt")).browser_download_url'
 ```
 
 ## 🐋 Docker Usage
 
 To provide a temporary container to experiment with `Black Mirror` scripts and the CLI utilities it uses, run the following:
 
-```
+```bash
 docker container run -it --rm -h black-mirror ghcr.io/t145/black-mirror
 ```
 
 For a persistant container, use something like what's given below:
 
-```
-docker container run -it --name black-mirror -h black-mirror black-mirror
+```bash
+docker container run -it --name black-mirror -h black-mirror ghcr.io/t145/black-mirror
 ```
 
 ## 🛠️ List Usage
 
-### Desktop OS Hosts File
+### Hosts File
 
 ```bash
 mawk '{print "0.0.0.0 " $0}' black_domain.txt >>hosts
@@ -277,32 +277,33 @@ mawk '{print "0.0.0.0 " $0}' black_ipv4.txt >>hosts
 mawk '{print ":: " $0}' black_ipv6.txt >>hosts
 ```
 
-### dnsmasq
+### [Dnsmasq](https://dnsmasq.org/)
 
-Many popular platforms such as OpenWRT, DDWRT, and Pihole use DNSmasq as their choice TCP powerhouse. After inspecting many domain blocklists you'll inevitably run across a list in the `dnsmasq.conf` format. This list doesn't support it because you can use the `addn-hosts` parameter to add hosts in the list.
-Target a file that has the hosts in a format similar to the `Desktop OS Hosts File format`.
+Many popular platforms such as OpenWRT, DDWRT, and Pi-hole use Dnsmasq as their choice TCP powerhouse. After inspecting many domain blocklists you'll inevitably run across a list in the `dnsmasq.conf` format. This list doesn't support it because you can use the `addn-hosts` parameter to add hosts in the list.
+Target a file that has the hosts in a format similar to the **Hosts File** format.
 
 If you're using the `RADVD` daemon, prepend any listed hosts with [`::`](https://stackoverflow.com/questions/40189084/what-is-for-localhost-and-0-0-0-0). Otherwise, even if you have IPv6 support set up, prepend hosts with [`0.0.0.0`](https://github.com/StevenBlack/hosts#we-recommend-using-0000-instead-of-127001).
 
 This has been tested across all the mentioned platforms using `dig{6}` on a small sample size and had each host null-routed successfully. [DNSmasq's man page](https://thekelleys.org.uk/dnsmasq/docs/dnsmasq-man.html) discusses configuration further, and [DDWRT's ad blocking wiki page](https://wiki.dd-wrt.com/wiki/index.php/Ad_blocking) provides some examples.
 
 #### Amazon EC2 DNS Resolver
 
-Follow [this guide](https://aws.amazon.com/premiumsupport/knowledge-center/dns-resolution-failures-ec2-linux/) to create a DNS server on a Amazon EC2 instance.
+Follow [this guide](https://aws.amazon.com/premiumsupport/knowledge-center/dns-resolution-failures-ec2-linux/) to create a DNS server on an Amazon EC2 instance.
 
-### pihole
+### [Pi-hole](https://pi-hole.net/)
 
-If you'd like to update when some sources do or not extract a production build, just use the [single-line list](https://discourse.pi-hole.net/t/how-to-add-blocklists-v5-and-later/32127) [`sources.pihole`](https://github.com/T145/black-mirror/blob/master/dist/sources.pihole). Note that this list only contains Pihole-compatible sources, and not every handled source. Some manual configuration may also be required.
+If you'd like to update when some sources do or not extract a production build, just use the [single-line list](https://discourse.pi-hole.net/t/how-to-add-blocklists-v5-and-later/32127) [`sources.pihole`](https://github.com/T145/black-mirror/blob/master/dist/sources.pihole).
+Note that this list only contains Pihole-compatible sources, and not every handled source. Some manual configuration may also be required.
 
-### unbound
+### [unbound](https://nlnetlabs.nl/projects/unbound/about/)
 
 Similar to dnsmasq, but requires more manual configuration. Name any products as a \*.conf file. [Then follow Steffinstanly's instructions on how to apply blocklists](https://medium.com/@steffinstanly/unbound-dns-blocking-3567986a5735).
 
-### personalDNSfilter
+### [personalDNSfilter](https://github.com/IngoZenz/personaldnsfilter)
 
 Use the domain list.
 
-### adguard
+### [Adguard](https://adguard.com/en/welcome.html)
 
 Leverage the [`sources.adguard`](https://github.com/T145/black-mirror/blob/master/dist/sources.adguard) list or the domain list.
 
@@ -513,7 +514,7 @@ Leverage the [`sources.adguard`](https://github.com/T145/black-mirror/blob/maste
   - analytics
   - enrichments
 
-#### TODO
+#### Add to blacklist
 
 - [Yuki2718](https://github.com/Yuki2718/adblock)
 - [Mochi Filter](https://github.com/eEIi0A5L/adblock_filter/blob/master/mochi_filter.txt)
@@ -618,7 +619,7 @@ Leverage the [`sources.adguard`](https://github.com/T145/black-mirror/blob/maste
   - custom-porn-whitelist
 - [metalhead](https://github.com/T145/metalhead)
 
-#### TODO
+#### Add to whitelist
 
 - [trackerslist](https://github.com/ngosang/trackerslist)
   - trackers_all
@@ -636,7 +637,7 @@ Leverage the [`sources.adguard`](https://github.com/T145/black-mirror/blob/maste
 - [quindecim](https://github.com/quindecim/block)
   - [domains-allowlist](https://github.com/quindecim/block/blob/master/config/domains-allowlist.txt)
 - [CryptoScamDB](https://github.com/CryptoScamDB)
-  - [blacklist](https://api.cryptoscamdb.org/v1/whitelist)
+  - [whitelist](https://api.cryptoscamdb.org/v1/whitelist)
 
 ### 🥢 Duplicates
 

README.md

@@ -11,8 +11,6 @@ Home: <https://etip.exodus-privacy.eu.org/trackers/all>
 - [Mirror 1](https://raw.githubusercontent.com/blokadaorg/landing-github-pages/master/blocklists/exodusprivacy/standard/hosts.txt)
 - [Mirror 2](https://blokada.org/blocklists/exodusprivacy/standard/hosts.txt)
 
-#### References
-
 - <https://community.blokada.org/t/introducing-exodus-privacy-to-blokada/7358>
 - <https://github.com/blokadaorg/landing-github-pages/blob/master/scripts/exodus.py>
 
@@ -22,8 +20,6 @@ Home: <https://etip.exodus-privacy.eu.org/trackers/all>
 
 Home: <https://twitter.com/Certego_Intel>
 
-#### References
-
 - <https://github.com/scafroglia93/blocklists/blob/master/blocklists-certego.txt>
 
 ---

data/v1/README.md

@@ -1,8 +1,8 @@
-## OISD
+# OISD
 
 *Note: Any lists covered in Black Mirror or are offline are not listed.*
 
-### 🥢 Duplicates
+## 🥢 Duplicates
 
 > Sources that contain duplicate and potentially deprecated data.
 
@@ -53,7 +53,7 @@
 - [sspakrac](https://www.sspakrac.hr/blokiraniurl/hosts.txt)
   - Ancient `WinHelp` version.
 
-### 🧟 Zombies
+## 🧟 Zombies
 
 > Sources that are dead or deprecated and not included but may be [worth mentioning](https://blog.talosintelligence.com/2021/03/domain-dumpster-diving.html).