İçeriğe geç

Projeler 2026 yayında

oku

Bir dokümantasyon araç takımı. Sayfalar Markdown ile yazılıp tarayıcıda çiziliyor; tek bir komut aramalı bir site, bir llms.txt ve her sayfanın tek dosyalık kopyasını üretiyor.

Python, Web Components

oku, dokümantasyon hazırlamak için bir araç takımı. Sayfaları sıradan Markdown olarak yazıyorsunuz. Grafikleri, tabloları, diyagramları ve adım akışlarını da aynı Markdown'ın içine, türü belirtilmiş kod blokları olarak ekliyorsunuz. Tarayıcı bunları Custom Element'lerle çiziyor.

Tek bir komut, arama özelliği olan çok sayfalı bir site oluşturuyor ve LLM okuyucular için bir llms.txt dosyası çıkarıyor. Aynı komut her sayfanın, dışarıdan hiçbir şeye ihtiyaç duymayan tek dosyalık bir kopyasını da üretiyor. Bu kopya e-posta ekinden açılabiliyor ve işletim sisteminin temasına uyuyor. Mermaid, Prism ve yazı tipleri CDN'den yüklenmiyor, çıktının yanında geliyor.

Yazan taraf olarak Markdown yazmaya devam ediyorsunuz. GitHub, Obsidian ve VS Code düz metni, tabloları ve Mermaid diyagramlarını yine gösteriyor, oku-* kod blokları ise orada okunabilir JSON olarak görünüyor. oku check, bir gözden geçirenin bakacağı şema, yapı ve sunum kurallarını çalıştırıyor. Bu kurallardan geçemeyen sayfa derlenmiyor.

Tablo başvuru sayfası: solda bir tablo bloğunun JSON'u, sağda sıralanabilir tablo hâli Koyu temada diyagram başvuru sayfası: bir Mermaid bloğu ve ondan çizilen akış Bütün sayfalarda İngilizce ve Türkçe tam metin arama, eşleşmeler vurgulanmış

Raporlarımı ve tasarım belgelerimi oku ile yazıyorum. Kendi dokümantasyonu da oku ile hazırlanıyor.