docmd: داکیومنتنویسی با یه دستور
هوش مصنوعی
سئو
فرانتاندخلاصهٔ کاملتر
اگه تا حالا برای نوشتن داکیومنت پروژهات سراغ ابزارهایی مثل Docusaurus، MkDocs یا VitePress رفتی، احتمالاً با کلی کانفیگ و وابستگیهای فریمورکی روبرو شدی. docmd اومده این درد رو حل کنه — یه موتور داکیومنتیشن زیروکانفیگ که با یه دستور ساده، فایلهای Markdown رو به یه سایت کامل و آماده برای پروداکشن تبدیل میکنه.
کافیه npx @docmd/core dev رو اجرا کنی. ابزار خودش فایلهای Markdown رو پیدا میکنه، در کمتر از یه ثانیه بیلد میکنه، ایندکس جستجو میسازه، و یه سرور محلی برات بالا میاره. نه bundler، نه babel، نه هیچ چیز اضافهای.
یه چیزی که docmd رو از رقباش جدا میکنه اینه که اصلاً به هیچ فریموورکی وابسته نیست. خروجیاش HTML خالصه با کمتر از ۲۰ کیلوبایت JavaScript. همین باعث میشه سایتهایی که باهاش میسازی نمره Lighthouse 100 بگیرن — یعنی هم سریعان، هم سئوشون عالیه.
جستجو توی docmd کاملاً آفلاینه و نیازی به API key یا سرویس ابری نداره. یه جستجوی fuzzy روی کل محتوا داره که با میانبر Cmd+K باز میشه. برای پروژههای چندزبانه هم ایندکس جداگانه برای هر لوکیل میسازه.
برای نوشتن محتوا هم نیازی به HTML نیست. docmd یه syntax اختصاصی برای container داره که توش میشه callout، تب، کارت، باکس هشدار و اطلاعات رو مستقیم توی Markdown نوشت — بدون اینکه یه خط HTML بزنی.
قابلیتهای پروداکشن هم دست کمی از ابزارهای بزرگتر نداره. تم روشن و تاریک، پشتیبانی چندزبانه با URL های locale-first، مدیریت نسخههای مختلف داکیومنت، و حتی دستور docmd deploy که فایلهای آماده برای Docker، Nginx و Caddy رو برات جنریت میکنه.
یه ویژگی جالب دیگه اینه که docmd بهصورت پیشفرض فایلهای llms.txt و llms-full.txt میسازه. این فایلها به مدلهای هوش مصنوعی کمک میکنن ساختار داکیومنت رو بهتر بفهمن و باهاش تعامل کنن — یه آپشن که خیلی از ابزارهای مشابه ندارن.
پلاگینهای اصلی مثل سئو، sitemap، جستجو و LLMs بهصورت پیشفرض همراهشه. پلاگینهای اختیاری مثل Mermaid، KaTeX، PWA و آنالیتیکس هم برای وقتی که بهشون نیاز داری در دسترسن. کل پروژه اپنسورسه و تحت لایسنس MIT منتشر شده.
نکات کلیدی:
- یه دستور کافیه تا سایت داکیومنتیشن آماده پروداکشن داشته باشی
- بدون React، بدون فریمورک — فقط HTML خالص با کمتر از ۲۰KB جاوااسکریپت
- Lighthouse 100 و سئوی کامل بهصورت پیشفرض
- جستجوی fuzzy کاملاً آفلاین با پشتیبانی از چندزبانگی
- پشتیبانی از i18n، تم روشن/تاریک، ورژنینگ و دیپلوی با Docker
- آماده برای هوش مصنوعی با تولید خودکار llms.txt
- اپنسورس و رایگان با لایسنس MIT
