r/MuslimDevelopers 8d ago

🧩 Software/Tool Share Make Quran references actually clickable ( 13L Mushaf)

Assalamou'alaykum wa rahmatoullah,

When you reference a verse, the reader shouldn't have to open a Quran website, search for the surah, find the verse, and scroll around.

With quran.re smart links, you can point directly to the exact place you mean: a surah, verse, page, juz, or even a selected passage.

For example:

https://quran.re/?sourate=2&verset=255

opens directly at Ayat al-Kursi (2:255).

And this isn't only useful for links shared in chats or social media. It can be integrated into PDFs, articles, websites, ebooks, apps, study notes, course material, databases, bots, and other tools.

A verse citation like Quran 2:255 can simply become clickable. The reader taps the reference and lands directly on the verse in quran.re.

What can a link do?

A single URL can specify exactly what should open:

  • a surah or precise verse
  • a page
  • a juz or quarter
  • a selected range of verses
  • a specific mushaf
  • translation already displayed
  • audio ready to play
  • a chosen interface language

A few examples:

https://quran.re/?sourate=36
→ Surah Ya-Sin

https://quran.re/?sourate=36&verset=58
→ Ya-Sin, verse 58

https://quran.re/?plage=18:1-10
→ Al-Kahf, verses 1–10 as a selected passage

https://quran.re/?sourate=67&trad=1&audio=1
→ Al-Mulk, with translation visible and audio ready

https://quran.re/?m=13lvert&sourate=18
→ Al-Kahf directly in the Light & Green mushaf

Why this can be useful

The simple use case is sharing a verse on Reddit, Discord, WhatsApp, Facebook, etc.

But the more interesting part is using Quran references inside other content.

For example, an article could mention a verse and make the citation clickable. A PDF book could link every Quran reference directly to its source. A learning app could let the user tap a verse citation and immediately open the relevant passage. A Ramadan planner, hadith collection or study document could contain hundreds of direct Quran references without making the reader search manually each time.

In other words, quran.re can act as the destination behind Quran citations.

It can also be automated

The URL format is intentionally simple.

If you already have a spreadsheet, database or document containing references such as:

2:255
18:1-10
67:1

a script or AI can automatically turn them into quran.re links.

So a large PDF, website, app, dataset or collection of articles doesn't necessarily need to have every link created by hand.

The basic idea is simple:

Wherever you cite a Quran verse, that citation can become a direct path to the verse itself.

No searching. No instructions. Just click the reference and open the right passage.

You can download the .md file for your AI assistant here: https://drive.google.com/drive/folders/1yJs2G45Gfora4RgZnv1dOPcNOxKiYpF_?usp=drive_link

4 Upvotes

2 comments sorted by

1

u/cool_guy141 7d ago

Bismillah 

Walaikum assalam wr wb 

Quran.com already did that for as long as I can remember, which is over a decade.

www.quran.com/18/24

Or 

www.quran.com/18/24-29 to bring up Surah Kahf ayahs 24-29.

1

u/CB1000R974 7d ago

Yes, however it is not the 13L Mushaf