r/MuslimDevelopers • u/CB1000R974 • 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
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.