راهنمای ویرایشگر Markdown با پیشنمایش راستبهچپ
زمان مطالعه: ۳ دقیقه
این ابزار چیست؟
مارکداون قالبی ساده برای نوشتن متن ساختیافته است: عنوان با #، پررنگ با ستاره، فهرست با خط تیره. فایلهای README، مستندات پروژه، یادداشتهای تیمی و بسیاری از وبلاگها با همین قالب نوشته میشوند. این ویرایشگر در یک سمت متن مارکداون را میگیرد و در سمت دیگر پیشنمایش زندهی راستبهچپ را نشان میدهد.
نوار ابزار برای قالبهای پرکاربرد دارد و یک دکمهی ویژهی فارسی برای نیمفاصلهگذاری. پیشنویس فقط در همین مرورگر نگه داشته میشود و پیشنمایش HTML خام را اجرا نمیکند، پس چسباندن متن ناشناس بیخطر است.
گامبهگام
متن را بنویسید یا بچسبانید
در کادر سمت راست بنویسید؛ پیشنمایش با کمی تأخیر کنار آن بهروز میشود. روی صفحهی کوچک پیشنمایش زیر ویرایشگر میآید.
از نوار ابزار استفاده کنید
بخش دلخواه را انتخاب کنید و یکی از دکمههای عنوان، پررنگ، پیوند، فهرست یا کد را بزنید. دکمهی عنوان با هر بار فشردن سطح عنوان را یک پله بالا میبرد.
جدول درج کنید
با دکمهی جدول تعداد سطر و ستون را بدهید تا قالب خالی جدول در جای مکاننما بیاید و فقط سلولها را پر کنید.
نیمفاصلهها را درست کنید
دکمهی نیمفاصلهگذاری فاصلههای اشتباه در واژههایی مثل «می روم» یا «کتاب ها» را اصلاح میکند و داخل بلوکهای کد را دست نمیزند.
خروجی بگیرید
فایل را با نام document.md دانلود کنید، پیشنمایش را چاپ کنید تا ذخیره بهصورت PDF ممکن شود، یا متن را به ابزار دیگری بفرستید.
نمونههای کاربردی
نیمفاصلهگذاری یک جمله
متن را بارگذاری کنید و دکمهی نیمفاصلهگذاری را بزنید؛ پیشوند «می» و پسوند «ها» با نیمفاصله به واژه میچسبند.
من می روم و کتاب ها را می خوانم.
نتیجه: من میروم و کتابها را میخوانم.
کد دستنخورده میماند
همان اصلاح روی متنی با بلوک کد اجرا کنید؛ فقط جملهی بیرون از بلوک اصلاح میشود و داخل بلوک همان که بود میماند.
متن: می روم ``` می روم ```
نتیجه: فقط متن بیرون از بلوک کد اصلاح میشود
قالب خالی جدول
در پنجرهی درج جدول یک سطر و دو ستون بخواهید؛ سرستونها شمارهدار ساخته میشوند و باید نامهایشان را عوض کنید.
نتیجه: سرستونها: ستون ۱ و ستون ۲
اشتباههای رایج
- پیشنمایش این ابزار HTML خام را اجرا نمیکند. اگر برچسب HTML نوشتهاید و نمایش داده نمیشود، از قالبهای خود مارکداون استفاده کنید.
- برای رفتن به سطر بعد داخل یک بند باید یا یک سطر خالی بگذارید یا انتهای سطر دو فاصله بنویسید؛ یک Enter ساده معمولاً در خروجی به هم میچسبد.
- دکمهی نیمفاصلهگذاری فقط الگوهای شناختهشده را اصلاح میکند و غلطیاب نیست. پس از اجرا یک بار متن را بخوانید، بهویژه واژههای ترکیبی نادر.
- پاککردن پیشنویس، متن ذخیرهشدهی مرورگر را هم حذف میکند. اگر نوشته مهم است، قبل از آن خروجی بگیرید.
مارکداون و نوشتن فارسی
مارکداون برای زبان انگلیسی طراحی شد، اما با متن راستبهچپ هم خوب کار میکند، چون فقط به نشانهگذاری ساده تکیه دارد. نکتهی اصلی جهت پاراگرافهاست: هر بند باید جهت خودش را از نخستین حرف قوی بگیرد تا ترکیب متن فارسی و انگلیسی در یک سند بههم نریزد.
نشانههای ستاره و زیرخط برای تأکید با متن فارسی هم کار میکنند، اما در فارسی رسم است بهجای مورب از پررنگ استفاده کنید، چون حروف مورب فارسی خوانا نیستند.
نیمفاصله چرا اهمیت دارد؟
در املای فارسی بعضی ترکیبها باید با فاصلهی نصفه نوشته شوند: «میروم» و «کتابها». اگر بهجای آن فاصلهی کامل بگذارید، واژه دو تکه خوانده میشود و جستوجو و کپی هم دقیق کار نمیکند. اگر نیمفاصله را نگذارید و حروف را بچسبانید، شکل واژه عوض میشود.
نیمفاصله یک نویسهی نامرئی یونیکد است (U+200C). ابزار نیمفاصلهگذاری برای متنهایی است که از جای دیگر کپی شده و این نویسه در آنها گم شده است.
پرسشهای متداول
- چرا HTML داخل متن نمایش داده نمیشود؟
- برای امنیت، تگهای HTML در پیشنمایش حذف میشوند و پیوندهای خطرناک (مانند javascript:) غیرفعالاند. فقط سینتکس Markdown و جدولهای GFM نمایش داده میشود.
- متن من کجا ذخیره میشود؟
- پیشنویس فقط در حافظهی همین مرورگر (localStorage) نگه داشته میشود و به سرور نمیرود. با «پاککردن پیشنویس» حذف میشود.
- چطور خروجی PDF بگیرم؟
- دکمهی «چاپ پیشنمایش» را بزنید و در پنجرهی چاپ مرورگر مقصد را «ذخیره بهصورت PDF» بگذارید؛ فقط پیشنمایش چاپ میشود.