آموزش Obsidian؛ ساخت دفتر یادگیری برنامه‌نویسی با یادداشت‌های پیوندی
راهنمای شروع Obsidian در ویندوز؛ ساخت Vault، ثبت مفهوم و خطای پروژه، اتصال یادداشت‌ها، استفاده از قالب Markdown و برنامه پشتیبان‌گیری بدون وابستگی به افزونه‌های جانبی.
یک خطای برنامه‌نویسی را حل کرده‌اید، اما دو هفته بعد نه علتش را به یاد دارید و نه صفحه‌ای را که راه‌حل در آن بود. مشکل همیشه کمبود اطلاعات نیست؛ گاهی یادداشت‌ها به پروژه و موقعیتی که در آن استفاده شده‌اند وصل نیستند. در این آموزش Obsidian یک دفتر کوچک می‌سازیم که در آن مفهوم، پروژه و خطا به یکدیگر پیوند دارند. هدف این نیست که همه جزوه‌ها را وارد برنامه کنید؛ هدف این است که یک پاسخ مفید را دوباره پیدا کنید.
این راهنما برای شروع در ویندوز نوشته شده و به افزونه جانبی نیاز ندارد. تمرین‌ها سناریوی آموزشی هستند، نه گزارش آزمایش روی پروژه واقعی شما. نام گزینه‌ها بر اساس مستندات رسمی آمده است و ممکن است جای آن‌ها با نسخه یا زبان رابط کمی تغییر کند.
Obsidian چیست و برای چه کاری مناسب است؟
Obsidian یادداشت‌های شما را به‌شکل فایل متنی Markdown در یک پوشه محلی نگه می‌دارد. به این پوشه Vault می‌گویند. می‌توانید متن‌ها را با ویرایشگر دیگری هم باز کنید؛ بنابراین دانسته‌هایتان صرفاً داخل یک صفحه وب قرار نمی‌گیرند. پوشه .obsidian درون Vault برای تنظیمات همان دفتر استفاده می‌شود. جزئیات در راهنمای ذخیره‌سازی داده توضیح داده شده است.
ارزش اصلی این روش برای هنرجوی برنامه‌نویسی، رابطه بین یادداشت‌هاست: یادداشت «رویداد کلیک» به پروژه «فرم ثبت‌نام» وصل می‌شود و یادداشت «اجرا نشدن رویداد» هر دو را به هم مرتبط می‌کند. متن را با زبان خودتان می‌نویسید و کنار آن منبع، محدودیت و سؤال باقی‌مانده را ثبت می‌کنید. کپی‌کردن یک آموزش طولانی بدون توضیحِ کاربردش، معمولاً دفتر شما را فقط بزرگ‌تر می‌کند.
برای استفاده محلی، ساخت حساب یا خرید اشتراک لازم نیست. Sync برای همگام‌سازی و Publish برای انتشار وب، سرویس‌های اختیاری جداگانه‌اند. قیمت و شرایط آن‌ها را پیش از تصمیم‌گیری از صفحه رسمی قیمت‌گذاری ببینید؛ این آموزش به خرید هیچ‌کدام وابسته نیست.
نصب رسمی و ساخت اولین Vault
۱. نصب در ویندوز
- از راهنمای رسمی نصب به صفحه دانلود بروید و نسخه Windows را بگیرید.
- فایل نصب را اجرا کنید و مراحل نصب را طی کنید. برای این تمرین نیازی به نسخه‌های دست‌کاری‌شده، کرک یا بسته افزونه آماده ندارید.
- برنامه را باز کنید و به صفحه انتخاب یا ساخت Vault بروید.
نسخه‌های موبایل هم مسیر رسمی دانلود دارند، اما بهتر است ابتدا دفتر کوچک این تمرین را روی یک دستگاه کامل کنید. نصب برنامه روی گوشی به‌تنهایی به این معنی نیست که فایل‌های لپ‌تاپ در آن ظاهر می‌شوند؛ همگام‌سازی مرحله مستقلی است.
۲. ساخت دفتر محلی
مقابل Create new vault گزینه Create را انتخاب کنید، نام را Learning-Notes بگذارید و با Browse پوشه‌ای قابل شناسایی در فضای شخصی خود انتخاب کنید. سپس Create را بزنید. اگر از قبل پوشه یادداشت دارید، گزینه Open folder as vault برای بازکردن همان پوشه است؛ در این تمرین از دفتر تازه استفاده کنید تا فایل‌های قبلی دست‌نخورده بمانند. این مراحل مطابق مستند ساخت Vault هستند.
مسیر واقعی پوشه را جایی ثبت کنید. نام Vault به‌تنهایی برای پیدا کردن فایل‌ها بعد از تعویض دستگاه کافی نیست. آن را داخل پوشه سیستمی یا درون Vault دیگری نسازید. پیش از اضافه‌کردن سرویس ابری نیز تکلیف پشتیبان‌گیری و شیوه همگام‌سازی را روشن کنید.
ساختار ساده‌ای که با یادگیری رشد می‌کند
پیشنهاد این تمرین چهار پوشه است: Concepts برای مفهوم‌ها، Projects برای پروژه‌ها، Bugs برای خطاها و Templates برای قالب‌ها. این تقسیم‌بندی یک پیشنهاد آموزشی است، نه قانون Obsidian. اگر فقط چند یادداشت دارید، از ساخت پوشه‌های تو در تو و دسته‌بندی بسیار جزئی خودداری کنید.
| نوع یادداشت | چه چیزی بنویسیم؟ | نمونه عنوان |
|---|---|---|
| مفهوم | تعریف با زبان خودمان، کاربرد و یک مرز یا استثنا | رویداد کلیک |
| پروژه | مسئله، تصمیم‌ها و معیار تمام‌شدن | فرم ثبت‌نام |
| خطا | نشانه، راه بازتولید، علت تأییدشده و اقدام بعدی | اجرا نشدن رویداد |
| قالب | پرسش‌هایی که هر بار باید پاسخ داده شوند | Learning-note |
برای عنوان، عبارتی انتخاب کنید که بعدها واقعاً آن را جست‌وجو می‌کنید. «نکته مهم ۷» زمینه‌ای نمی‌دهد، اما «اجرا نشدن رویداد بعد از تغییر HTML» مشخص‌تر است. نام‌گذاری را در طول زمان یکدست نگه دارید و از ثبت چند فایل تقریباً هم‌نام برای یک مفهوم پرهیز کنید.
تمرین اصلی: سه یادداشت را به هم وصل کنید
گام اول: یادداشت مفهوم
در پوشه Concepts یادداشتی با عنوان «رویداد کلیک» بسازید. چهار بخش کوتاه بنویسید: این مفهوم چیست، کجا استفاده می‌شود، چه چیزی را هنوز نمی‌دانم و منبع من چیست. یک جمله پیشنهادی برای بخش کاربرد این است: «در تمرین فرم ثبت‌نام، می‌خواهم واکنش رابط به کلیک کاربر را مشخص کنم.» این جمله به‌اندازه کافی مشخص است که بعداً بتوانید آن را به یک پروژه وصل کنید.
گام دوم: یادداشت پروژه
در Projects یادداشت «فرم ثبت‌نام» را ایجاد کنید. مسئله را از راه‌حل جدا بنویسید: مسئله می‌تواند «نمایش بازخورد واضح پس از تعامل کاربر» باشد؛ راه‌حل پیشنهادی شما باید جداگانه ثبت و آزمایش شود. سپس در متن یادداشت، [[Concepts/رویداد کلیک]] را وارد کنید. برای کاهش اشتباه، پس از تایپ دو کروشه باز، مقصد را از پیشنهادهای خود Obsidian انتخاب کنید.
Obsidian از پیوندهای دوکروشه‌ای یا Wikilink و لینک‌های Markdown پشتیبانی می‌کند. در مسیر پوشه حتی روی ویندوز از / استفاده می‌شود. می‌توانید به یک بخش خاص هم ارجاع دهید؛ مثلاً اگر یادداشت مقصد تیتر «کاربرد» دارد، [[Concepts/رویداد کلیک#کاربرد]] به همان بخش اشاره می‌کند. برای جزئیات قالب‌ها، مستند لینک‌های داخلی را ببینید.
گام سوم: یادداشت خطا، بدون نتیجه‌سازی
در Bugs یادداشت «اجرا نشدن رویداد» بسازید و دو لینک به یادداشت مفهوم و پروژه قرار دهید. فعلاً ننویسید «مشکل از انتخابگر بود» مگر واقعاً آن را بررسی کرده باشید. به‌جای آن ثبت کنید: نشانه چه بود، کدام مرحله را انجام دادید، چه انتظاری داشتید، چه اتفاقی افتاد و فرضیه بعدی چیست. وقتی علت را تأیید کردید، تاریخ و نتیجه بررسی را اضافه کنید.
این تمایز کوچک جلوی تبدیل حدس به دانش اشتباه را می‌گیرد. در یک پروژه واقعی، قبل از کپی‌کردن خروجی خطا، نام کاربر، توکن، آدرس خصوصی و داده مشتری را حذف کنید. دفتر یادگیری محل نگهداری رمز عبور یا کلید API نیست.
گام چهارم: دیدن رابطه از سمت مقابل
یادداشت «رویداد کلیک» را باز کنید و در پنل Backlinks بخش Linked mentions را ببینید. در آنجا باید یادداشت‌هایی را پیدا کنید که به این مفهوم لینک داده‌اند. اگر پنل را نمی‌بینید، از Command palette دستور Backlinks: Show backlinks را پیدا کنید. بخش Unlinked mentions با لینک واقعی فرق دارد: نام یادداشت در متن آمده، اما الزاماً پیوندی ساخته نشده است. توضیح این تفاوت در راهنمای Backlinks آمده است.
یک قالب Markdown برای ثبت دانسته‌ها
یک قالب کوتاه کمک می‌کند یادداشت ناقص را تشخیص دهید. در Templates فایلی با نام Learning-note.md بسازید و نمونه زیر را در حالت Source mode وارد کنید. این متن یک قالب یادداشت است، نه برنامه اجرایی. بخش‌های خالی را با تجربه و منبع خودتان کامل کنید؛ قرار نیست هر بار متن طولانی بنویسید.
# {{title}}Date: {{date:YYYY-MM-DD}} ## Question ## Explanation in my own words ## Evidence and source ## Related project ## Next check- [ ] Verify one concrete exampleتیترها را می‌توانید فارسی کنید: سؤال، توضیح با زبان خودم، شاهد و منبع، پروژه مرتبط و بررسی بعدی. متغیرهای داخل دو آکولاد را بدون تغییر نگه دارید. در تنظیمات، افزونه داخلی Templates را فعال و مسیر Template folder location را روی Templates قرار دهید. داخل یک یادداشت تازه، دستور Templates: Insert template را اجرا و قالب را انتخاب کنید. در زمان درج، عنوان و تاریخ جایگزین می‌شوند؛ کپی ساده متن الزاماً این متغیرها را پردازش نمی‌کند. مرجع این رفتار مستند Templates است.
برای مشاهده متن خام Markdown از Source mode و برای مرور خروجی از Reading view استفاده کنید. در ویندوز میانبر Ctrl+E بین نمای مطالعه و ویرایش جابه‌جا می‌شود. اگر نشانه‌های قالب‌بندی را نمی‌بینید، ممکن است در Live Preview باشید؛ این موضوع الزاماً به معنی حذف‌شدن نشانه‌ها نیست. راهنمای حالت‌های نمایش تفاوت آن‌ها را توضیح می‌دهد.
آیا دفتر واقعاً قابل استفاده شده است؟
به‌جای شمارش فایل‌ها، با چند سؤال کوچک کیفیت دفتر را بسنجید. این‌ها معیارهای پیشنهادی تمرین هستند و نتیجه‌ای از پیش اندازه‌گیری‌شده را ادعا نمی‌کنند:
- از یادداشت پروژه می‌توانید به مفهوم مورد استفاده بروید؟
- از Backlinks همان مفهوم، پروژه و خطای مرتبط را پیدا می‌کنید؟
- در یادداشت خطا، مشاهده واقعی از فرضیه جداست؟
- لینک منبع را کنار ادعایی گذاشته‌اید که بعداً باید دوباره بررسی شود؟
- اگر نام یک یادداشت عوض شد، مقصد لینک‌ها را دوباره کنترل کرده‌اید؟
- یک نسخه پشتیبان دارید که بازکردن آن را در پوشه‌ای جدا بررسی کرده باشید؟
برای یافتن متن در دفتر از Search استفاده کنید. میانبر ویندوز Ctrl+Shift+F است. عبارت path:Projects جست‌وجو را بر اساس مسیر محدود می‌کند و content:"رویداد" برای متن داخل یادداشت کاربرد دارد. نتیجه به فایل‌های واقعی شما بستگی دارد؛ اگر چیزی پیدا نشد، ابتدا نام پوشه و متن ثبت‌شده را بررسی کنید. توضیحات عملگرها در راهنمای جست‌وجو موجود است.
امنیت و پشتیبان‌گیری را به بعد موکول نکنید
شروع بدون افزونه جانبی
برای این دفتر، امکانات داخلی کافی هستند. Restricted mode به‌صورت پیش‌فرض اجرای افزونه‌های شخص ثالث را محدود می‌کند. افزونه‌های جامعه می‌توانند به فایل‌ها و اینترنت دسترسی داشته باشند و برنامه نمی‌تواند برای همه آن‌ها مجوزهای ریزدانه قابل اتکا اعمال کند. پس نصب یک افزونه را صرفاً تغییر ظاهر ندانید. اگر بعدها واقعاً نیاز داشتید، منبع و سطح دسترسی آن را بررسی کنید. این هشدار مبتنی بر مستند امنیت افزونه‌ها است.
فرق همگام‌سازی با بکاپ
همگام‌سازی برای یکسان‌کردن فایل‌ها بین دستگاه‌هاست؛ بکاپ باید امکان برگشت به نسخه‌ای مستقل را فراهم کند. برای شروع، یک برنامه منظم برای کپی تاریخ‌دار پوشه Vault به محل دیگری داشته باشید و بازیابی را روی یک کپی جدا بررسی کنید. پوشه اصلی را برای آزمایش پاک یا جایگزین نکنید. طبق راهنمای رسمی پشتیبان‌گیری، Sync و قابلیت File recovery جای یک راهکار بکاپ مستقل را نمی‌گیرند.
در تمرین بازیابی، چند فایل نمونه و پیوست را باز کنید، نه فقط نام پوشه را نگاه کنید. اگر از فضای ابری استفاده می‌کنید، حساب، دسترسی و محرمانگی فایل‌ها را بررسی کنید. نگهداری یک کپی در همان دیسک، به‌تنهایی در برابر خرابی آن دیسک کافی نیست.
Obsidian را با ابزار پژوهش اشتباه نگیرید
در این روش، شما نویسنده و مسئول صحت یادداشت هستید. ارتباط‌دادن فایل‌ها به‌خودی‌خود ادعاها را درست نمی‌کند و نمودار زیبا هم جای فهمیدن مفهوم را نمی‌گیرد. اگر نیاز شما پرسش‌وپاسخ بر اساس یک مجموعه منبع است، آموزش دفتر پژوهش با NotebookLM مسیر دیگری را توضیح می‌دهد. می‌توانید خروجی بررسی‌شده پژوهش را به زبان خودتان در دفتر محلی خلاصه کنید؛ اطلاعات محرمانه را بدون مجوز به سرویس‌های آنلاین نفرستید.
پرسش‌های متداول
آیا برای شروع Obsidian باید اشتراک یا حساب بسازم؟
برای استفاده محلی از برنامه به حساب و اشتراک نیاز ندارید. سرویس‌های اختیاری Sync و Publish جدا از یادداشت‌برداری محلی هستند و شرایط آن‌ها را باید در صفحه رسمی بررسی کنید.
Vault چیست و فایل‌های من کجا ذخیره می‌شوند؟
Vault پوشه‌ای روی دستگاه شماست که یادداشت‌های Markdown و فایل‌های همراه را نگه می‌دارد. مسیر آن را هنگام ساخت انتخاب می‌کنید و باید برای همان پوشه برنامه پشتیبان‌گیری داشته باشید.
آیا برای این تمرین به افزونه هوش مصنوعی نیاز دارم؟
خیر. ایجاد یادداشت، لینک داخلی، Backlinks، جست‌وجو و قالب‌های این راهنما با امکانات اصلی و افزونه‌های داخلی Obsidian انجام می‌شوند.
آیا همگام‌سازی جای بکاپ را می‌گیرد؟
خیر. همگام‌سازی تغییرات را بین دستگاه‌ها منتقل می‌کند و ممکن است حذف اشتباه را هم منتقل کند. بکاپ مستقل و قابل بازیابی را جداگانه نگه دارید.
جمع‌بندی و تمرین بعدی
یک دفتر مفید از یک ساختار کوچک، عنوان‌های روشن، لینک‌های معنی‌دار و بازبینی منظم ساخته می‌شود. وقتی پاسخ یک مسئله را ثبت می‌کنید، زمینه و منبعش را هم بنویسید تا دانسته شما بعداً قابل استفاده بماند. بعد از چند جلسه، یادداشت‌های تکراری را پیدا کنید و عنوان‌ها را یکدست کنید؛ پیش از جابه‌جایی گسترده فایل‌ها نسخه پشتیبان بگیرید.
همین امروز سه یادداشتِ مفهوم، پروژه و خطا بسازید و بین آن‌ها لینک بگذارید؛ معیار موفقیت، پیدا کردن دوباره یک پاسخ کاربردی است، نه تعداد یادداشت‌ها.