Skip to content

Commit 01668d7

Browse files
authored
Some silly improvements (decoration) in README.md (#5974)
* Update README.md * Update README.md * Update README.md * Update README.md * beautified
1 parent 18552bf commit 01668d7

File tree

1 file changed

+85
-59
lines changed

1 file changed

+85
-59
lines changed

README.md

Lines changed: 85 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
![nuclei](/static/nuclei-cover-image.png)
22

3-
<p align="center">
4-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README.md">English</a> •
5-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_CN.md">中文</a> •
6-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_KR.md">Korean</a> •
7-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_ID.md">Indonesia</a> •
8-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_ES.md">Spanish</a> •
9-
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_JP.md">日本語</a>
10-
</p>
11-
12-
</p>
3+
<div align="center">
4+
5+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README.md">`English`</a> •
6+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_CN.md">`中文`</a> •
7+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_KR.md">`Korean`</a> •
8+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_ID.md">`Indonesia`</a> •
9+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_ES.md">`Spanish`</a>
10+
<a href="https://github.com/projectdiscovery/nuclei/blob/main/README_JP.md">`日本語`</a>
11+
12+
</div>
1313

1414
<p align="center">
1515

@@ -21,13 +21,13 @@
2121
&nbsp;&nbsp;
2222
<a href="https://discord.gg/projectdiscovery?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme"><img src="https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white"></a>
2323

24-
---
24+
<hr>
2525

2626
</p>
2727

28-
<br />
28+
<br>
2929

30-
Nuclei is a modern, high-performance vulnerability scanner that leverages simple YAML-based templates. It empowers you to design custom vulnerability detection scenarios that mimic real-world conditions, leading to zero false positives.
30+
**Nuclei is a modern, high-performance vulnerability scanner that leverages simple YAML-based templates. It empowers you to design custom vulnerability detection scenarios that mimic real-world conditions, leading to zero false positives.**
3131

3232
- Simple YAML format for creating and customizing vulnerability templates.
3333
- Contributed by thousands of security professionals to tackle trending vulnerabilities.
@@ -37,64 +37,76 @@ Nuclei is a modern, high-performance vulnerability scanner that leverages simple
3737
- Supports multiple protocols like TCP, DNS, HTTP, SSL, WHOIS JavaScript, Code and more.
3838
- Integrate with Jira, Splunk, GitHub, Elastic, GitLab.
3939

40-
## Table of Contents
40+
<br>
41+
<br>
4142

42-
- [Get Started](#get-started)
43-
- [1. Nuclei CLI](#1-nuclei-cli)
44-
- [2. Pro and Enterprise Editions](#2-pro-and-enterprise-editions)
45-
- [Documentation](#documentation)
46-
- [Command Line Flags](#command-line-flags)
47-
- [Single target scan](#single-target-scan)
48-
- [Scanning multiple targets](#scanning-multiple-targets)
49-
- [Network scan](#network-scan)
50-
- [Scanning with your custom template](#scanning-with-your-custom-template)
51-
- [Connect Nuclei to ProjectDiscovery](#connect-nuclei-to-projectdiscovery)
52-
- [Nuclei Templates, Community and Rewards 💎](#nuclei-templates-community-and-rewards-)
53-
- [Our Mission](#our-mission)
54-
- [Contributors ❤️](#contributors-️)
55-
- [License](#license)
43+
## Table of Contents
5644

45+
- [**`Get Started`**](#get-started)
46+
- [_`1. Nuclei CLI`_](#1-nuclei-cli)
47+
- [_`2. Pro and Enterprise Editions`_](#2-pro-and-enterprise-editions)
48+
- [**`Documentation`**](#documentation)
49+
- [_`Command Line Flags`_](#command-line-flags)
50+
- [_`Single target scan`_](#single-target-scan)
51+
- [_`Scanning multiple targets`_](#scanning-multiple-targets)
52+
- [_`Network scan`_](#network-scan)
53+
- [_`Scanning with your custom template`_](#scanning-with-your-custom-template)
54+
- [_`Connect Nuclei to ProjectDiscovery_`_](#connect-nuclei-to-projectdiscovery)
55+
- [**`Nuclei Templates, Community and Rewards`**](#nuclei-templates-community-and-rewards-) 💎
56+
- [**`Our Mission`**](#our-mission)
57+
- [**`Contributors`**](#contributors-heart)
58+
- [**`License`**](#license)
59+
60+
<br>
61+
<br>
5762

5863
## Get Started
5964

6065
### **1. Nuclei CLI**
6166

62-
Install Nuclei on your machine. Get started by following the installation guide [here](https://docs.projectdiscovery.io/tools/nuclei/install?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme). Additionally, We provide [a free cloud tier](https://cloud.projectdiscovery.io/sign-up) and comes with a generous monthly free limits:
67+
_Install Nuclei on your machine. Get started by following the installation guide [**`here`**](https://docs.projectdiscovery.io/tools/nuclei/install?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme). Additionally, We provide [**`a free cloud tier`**](https://cloud.projectdiscovery.io/sign-up) and comes with a generous monthly free limits:_
6368

6469
- Store and visualize your vulnerability findings
6570
- Write and manage your nuclei templates
6671
- Access latest nuclei templates
6772
- Discover and store your targets
6873

69-
| :exclamation: **Disclaimer** |
70-
|:--------------------------------|
71-
| **This project is in active development**. Expect breaking changes with releases. Review the release changelog before updating. |
72-
| This project is primarily built to be used as a standalone CLI tool. **Running nuclei as a service may pose security risks.** It's recommended to use with caution and additional security measures. |
74+
> [!Important]
75+
> |**This project is in active development**. Expect breaking changes with releases. Review the release changelog before updating.|
76+
> |:--------------------------------|
77+
> | This project is primarily built to be used as a standalone CLI tool. **Running nuclei as a service may pose security risks.** It's recommended to use with caution and additional security measures. |
78+
79+
<br>
7380

7481
### **2. Pro and Enterprise Editions**
7582

76-
For security teams and enterprises, we provide a cloud-hosted service built on top of Nuclei OSS, fine-tuned to help you continuously run vulnerability scans at scale with your team and existing workflows:
83+
_For security teams and enterprises, we provide a cloud-hosted service built on top of Nuclei OSS, fine-tuned to help you continuously run vulnerability scans at scale with your team and existing workflows:_
7784

7885
- 50x faster scans
7986
- Large scale scanning with high accuracy
8087
- Integrations with cloud services (AWS, GCP, Azure, CloudFlare, Fastly, Terraform, Kubernetes)
8188
- Jira, Slack, Linear, APIs and Webhooks
8289
- Executive and compliance reporting
8390
- Plus: Real-time scanning, SAML SSO, SOC 2 compliant platform (with EU and US hosting options), shared team workspaces, and more
84-
- We're constantly [adding new features](https://feedback.projectdiscovery.io/changelog)!
91+
- We're constantly [**`adding new features`**](https://feedback.projectdiscovery.io/changelog)!
8592
- **Ideal for:** Pentesters, security teams, and enterprises
8693

87-
[Sign up to Pro](https://projectdiscovery.io/pricing?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme) or [Talk to our team](https://projectdiscovery.io/request-demo?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme) if you have large organization and complex requirements.
94+
[**`Sign up to Pro`**](https://projectdiscovery.io/pricing?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme) or [**`Talk to our team`**](https://projectdiscovery.io/request-demo?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme) if you have large organization and complex requirements.
95+
96+
<br>
97+
<br>
8898

8999
## Documentation
90100

91-
Browse the full Nuclei [documentation here](https://docs.projectdiscovery.io/tools/nuclei/running). If you’re new to Nuclei, check out our [foundational Youtube series.](https://www.youtube.com/playlist?list=PLZRbR9aMzTTpItEdeNSulo8bYsvil80Rl)
101+
Browse the full Nuclei [**`documentation here`**](https://docs.projectdiscovery.io/tools/nuclei/running). If you’re new to Nuclei, check out our [**`foundational Youtube series`**](https://www.youtube.com/playlist?list=PLZRbR9aMzTTpItEdeNSulo8bYsvil80Rl).
92102

93-
<p align="center">
103+
<div align="center">
94104

95105
<a href="https://www.youtube.com/watch?v=b5qMyQvL1ZA&list=PLZRbR9aMzTTpItEdeNSulo8bYsvil80Rl&utm_source=github&utm_medium=web&utm_campaign=nuclei_readme" target="_blank"><img src="/static/nuclei-getting-started.png" width="350px"></a> <a href="https://www.youtube.com/watch?v=nFXygQdtjyw&utm_source=github&utm_medium=web&utm_campaign=nuclei_readme" target="_blank"><img src="/static/nuclei-write-your-first-template.png" width="350px"></a>
96106

97-
</p>
107+
</div>
108+
109+
<br>
98110

99111
### Installation
100112

@@ -104,7 +116,7 @@ Browse the full Nuclei [documentation here](https://docs.projectdiscovery.io/too
104116
go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
105117
```
106118

107-
To learn more about installing nuclei, see https://docs.projectdiscovery.io/tools/nuclei/install.
119+
To learn more about installing nuclei, see `https://docs.projectdiscovery.io/tools/nuclei/install`.
108120

109121
### Command Line Flags
110122

@@ -117,7 +129,7 @@ nuclei -h
117129
<details>
118130
<summary>Expand full help flags</summary>
119131

120-
```console
132+
```yaml
121133
Nuclei is a fast, template based vulnerability scanner focusing
122134
on extensive configurability, massive extensibility and ease of use.
123135

@@ -165,10 +177,10 @@ FILTERING:
165177
-it, -include-templates string[] path to template file or directory to be executed even if they are excluded either by default or configuration
166178
-et, -exclude-templates string[] path to template file or directory to exclude (comma-separated, file)
167179
-em, -exclude-matchers string[] template matchers to exclude in result
168-
-s, -severity value[] templates to run based on severity. Possible values: info, low, medium, high, critical, unknown
169-
-es, -exclude-severity value[] templates to exclude based on severity. Possible values: info, low, medium, high, critical, unknown
170-
-pt, -type value[] templates to run based on protocol type. Possible values: dns, file, http, headless, tcp, workflow, ssl, websocket, whois, code, javascript
171-
-ept, -exclude-type value[] templates to exclude based on protocol type. Possible values: dns, file, http, headless, tcp, workflow, ssl, websocket, whois, code, javascript
180+
-s, -severity value[] templates to run based on severity. Possible values - info, low, medium, high, critical, unknown
181+
-es, -exclude-severity value[] templates to exclude based on severity. Possible values - info, low, medium, high, critical, unknown
182+
-pt, -type value[] templates to run based on protocol type. Possible values - dns, file, http, headless, tcp, workflow, ssl, websocket, whois, code, javascript
183+
-ept, -exclude-type value[] templates to exclude based on protocol type. Possible values - dns, file, http, headless, tcp, workflow, ssl, websocket, whois, code, javascript
172184
-tc, -template-condition string[] templates to run based on expression condition
173185

174186
OUTPUT:
@@ -213,7 +225,7 @@ CONFIGURATIONS:
213225
-ca, -client-ca string client certificate authority file (PEM-encoded) used for authenticating against scanned hosts
214226
-sml, -show-match-line show match lines for file templates, works with extractors only
215227
-ztls use ztls library with autofallback to standard one for tls13 [Deprecated] autofallback to ztls is enabled by default
216-
-sni string tls sni hostname to use (default: input domain name)
228+
-sni string tls sni hostname to use (default - input domain name)
217229
-dka, -dialer-keep-alive value keep-alive duration for network requests.
218230
-lfa, -allow-local-file-access allows file (payload) access anywhere on the system
219231
-lna, -restrict-local-network-access blocks connections to the local / private network
@@ -227,7 +239,7 @@ CONFIGURATIONS:
227239
-hae, -http-api-endpoint string experimental http api endpoint
228240

229241
INTERACTSH:
230-
-iserver, -interactsh-server string interactsh server url for self-hosted instance (default: oast.pro,oast.live,oast.site,oast.online,oast.fun,oast.me)
242+
-iserver, -interactsh-server string interactsh server url for self-hosted instance (default - oast.pro,oast.live,oast.site,oast.online,oast.fun,oast.me)
231243
-itoken, -interactsh-token string authentication token for self-hosted interactsh server
232244
-interactions-cache-size int number of requests to keep in the interactions cache (default 5000)
233245
-interactions-eviction int number of seconds to wait before evicting requests from cache (default 60)
@@ -238,7 +250,7 @@ INTERACTSH:
238250
FUZZING:
239251
-ft, -fuzzing-type string overrides fuzzing type set in template (replace, prefix, postfix, infix)
240252
-fm, -fuzzing-mode string overrides fuzzing mode set in template (multiple, single)
241-
-fuzz enable loading fuzzing templates (Deprecated: use -dast instead)
253+
-fuzz enable loading fuzzing templates (Deprecated; use -dast instead)
242254
-dast enable / run dast (fuzz) nuclei templates
243255
-dfp, -display-fuzz-points display fuzz points in the output for debugging
244256
-fuzz-param-frequency int frequency of uninteresting parameters for fuzzing before skipping (default 10)
@@ -353,7 +365,7 @@ Additional documentation is available at: https://docs.nuclei.sh/getting-started
353365

354366
```
355367
356-
Additional documentation is available at: [https://docs.nuclei.sh/getting-started/running](https://docs.nuclei.sh/getting-started/running?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme)
368+
Additional documentation is available at: [**`docs.nuclei.sh/getting-started/running`**](https://docs.nuclei.sh/getting-started/running?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme)
357369

358370
</details>
359371

@@ -398,14 +410,17 @@ nuclei -target https://example.com -dashboard
398410
```
399411

400412
> [!NOTE]
401-
> This feature is absolutely free and does not require any subscription. For a detailed guide, refer to the [documentation](https://docs.projectdiscovery.io/cloud/scanning/nuclei-scan?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme).
413+
> This feature is absolutely free and does not require any subscription. For a detailed guide, refer to the [**`documentation`**](https://docs.projectdiscovery.io/cloud/scanning/nuclei-scan?utm_source=github&utm_medium=web&utm_campaign=nuclei_readme).
414+
415+
<br>
416+
<br>
402417

403418
## Nuclei Templates, Community and Rewards 💎
404-
[Nuclei templates](https://github.com/projectdiscovery/nuclei-templates) are based on the concepts of YAML based template files that define how the requests will be sent and processed. This allows easy extensibility capabilities to nuclei. The templates are written in YAML which specifies a simple human-readable format to quickly define the execution process.
419+
[**Nuclei templates**](https://github.com/projectdiscovery/nuclei-templates) are based on the concepts of YAML based template files that define how the requests will be sent and processed. This allows easy extensibility capabilities to nuclei. The templates are written in YAML which specifies a simple human-readable format to quickly define the execution process.
405420

406-
Try it online with our free AI powered Nuclei Templates Editor by [clicking here.](https://cloud.projectdiscovery.io/templates)
421+
**Try it online with our free AI powered Nuclei Templates Editor by** [**`clicking here`**](https://cloud.projectdiscovery.io/templates).
407422

408-
Nuclei Templates offer a streamlined way to identify and communicate vulnerabilities, combining essential details like severity ratings and detection methods. This open-source, community-developed tool accelerates threat response and is widely recognized in the cybersecurity world. Nuclei templates are actively contributed by thousands of security researchers globally. We run two programs for our contributors: [Pioneers](https://projectdiscovery.io/pioneers) and [💎 bounties](https://github.com/projectdiscovery/nuclei-templates/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%F0%9F%92%8E%20Bounty%22).
423+
Nuclei Templates offer a streamlined way to identify and communicate vulnerabilities, combining essential details like severity ratings and detection methods. This open-source, community-developed tool accelerates threat response and is widely recognized in the cybersecurity world. Nuclei templates are actively contributed by thousands of security researchers globally. We run two programs for our contributors: [**`Pioneers`**](https://projectdiscovery.io/pioneers) and [**`💎 bounties`**](https://github.com/projectdiscovery/nuclei-templates/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%F0%9F%92%8E%20Bounty%22).
409424

410425

411426
<p align="left">
@@ -414,7 +429,7 @@ Nuclei Templates offer a streamlined way to identify and communicate vulnerabili
414429

415430
#### Examples
416431

417-
Visit [our documentation](https://docs.projectdiscovery.io/templates/introduction) for use cases and ideas.
432+
Visit [**our documentation**](https://docs.projectdiscovery.io/templates/introduction) for use cases and ideas.
418433

419434
| Use case | Nuclei template |
420435
| :----------------------------------- | :------------------------------------------------- |
@@ -434,17 +449,23 @@ Visit [our documentation](https://docs.projectdiscovery.io/templates/introductio
434449
| File inclusion vulnerabilities | **[Local/Remote File Inclusion](https://cloud.projectdiscovery.io/public/CVE-2023-6977)** |
435450

436451

452+
<br>
453+
<br>
454+
437455
## Our Mission
438456

439457
Traditional vulnerability scanners were built decades ago. They are closed-source, incredibly slow, and vendor-driven. Today's attackers are mass exploiting newly released CVEs across the internet within days, unlike the years it used to take. This shift requires a completely different approach to tackling trending exploits on the internet.
440458

441459
We built Nuclei to solve this challenge. We made the entire scanning engine framework open and customizable—allowing the global security community to collaborate and tackle the trending attack vectors and vulnerabilities on the internet. Nuclei is now used and contributed by Fortune 500 enterprises, government agencies, universities.
442460

443-
You can participate by contributing to our code, [templates library](https://github.com/projectdiscovery/nuclei-templates), or [joining our team.](https://projectdiscovery.io/)
461+
You can participate by contributing to our code, [**`templates library`**](https://github.com/projectdiscovery/nuclei-templates), or [**`joining our team`**](https://projectdiscovery.io/).
462+
463+
<br>
464+
<br>
444465

445466
## Contributors :heart:
446467

447-
Thanks to all the amazing [community contributors for sending PRs](https://github.com/projectdiscovery/nuclei/graphs/contributors) and keeping this project updated. :heart:
468+
Thanks to all the amazing [**`community contributors for sending PRs`**](https://github.com/projectdiscovery/nuclei/graphs/contributors) and keeping this project updated. :heart:
448469

449470
<p align="left">
450471
<a href="https://github.com/Ice3man543"><img src="https://avatars.githubusercontent.com/u/22318055?v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
@@ -609,10 +630,15 @@ Thanks to all the amazing [community contributors for sending PRs](https://githu
609630
<a href="https://github.com/KristinnVikar"><img src="https://avatars.githubusercontent.com/u/93918469?v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
610631
<a href="https://github.com/kant01ne"><img src="https://avatars.githubusercontent.com/u/5072452?v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
611632
<a href="https://github.com/KeisukeYamashita"><img src="https://avatars.githubusercontent.com/u/23056537?v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
633+
<a href="https://github.com/1hehaq"><img src="https://avatars.githubusercontent.com/u/162917546?v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
612634
</p>
613635

614-
## License
636+
<br>
637+
<br>
638+
<br>
615639

616-
Nuclei is distributed under [MIT License](https://github.com/projectdiscovery/nuclei/blob/main/LICENSE.md).
640+
<div align="center">
641+
642+
<sub>**`nuclei`** is distributed under [**MIT License**](https://github.com/projectdiscovery/nuclei/blob/main/LICENSE.md)</sub>
617643

618-
<img src="https://img.shields.io/badge/license-MIT-000000.svg?style=for-the-badge">
644+
</div>

0 commit comments

Comments
 (0)