ویرایشگر Markdown
روی دستگاه شما اجرا می‌شود. چیزی ارسال نمی‌شود.همه چیز روی دستگاه خودتان انجام می‌شود. هیچ‌چیزی که تایپ می‌کنید به هیچکجا ارسال نمی‌شود.
Markdown
پیش‌نمایش
پیش‌نمایش رندرشده شما اینجا نمایش داده می‌شود
با پیش‌نمایش زنده Markdown بنویسید، سپس HTML تمیز یا فایل خام Markdown را خروجی بگیرید، کاملاً در مرورگر شما.
این ویرایشگر همزمان با تایپ شما، Markdown را به‌صورت زنده و کاملاً در مرورگرتان به HTML تبدیل می‌کند و از نحوی که مردم واقعاً هر روز از آن استفاده می‌کنند پشتیبانی می‌کند: عنوان‌ها، متن پررنگ و مورب، پیوندها، تصاویر، فهرست‌ها، نقل‌قول‌ها، کد درون‌خطی و بلوک‌های کد. هر چیزی که تایپ می‌کنید پیش از اعمال هرگونه قالب‌بندی به‌صورت HTML اسکیپ می‌شود، بنابراین HTML یا تگ‌های اسکریپت جای‌گذاری‌شده به‌جای اجرا شدن، به‌صورت متن ساده و قابل مشاهده نمایش داده می‌شوند - هیچ‌چیزی که می‌نویسید هرگز به‌جایی آپلود نمی‌شود.
پرسش‌های متداول
آیا این مشخصات کامل CommonMark است؟
خیر - این ابزار نحوی را پوشش می‌دهد که مردم بیشتر روزانه از آن استفاده می‌کنند (عنوان‌ها، تأکید، پیوندها، تصاویر، فهرست‌ها، نقل‌قول‌ها، کد)، نه مشخصات کامل CommonMark با تمام موارد خاص آن مانند فهرست‌های تودرتو، جداول یا پانویس‌ها. برای یادداشت‌های روزمره، فایل‌های README و مستندات، این زیرمجموعه اصلی اکثریت قریب‌به‌اتفاق Markdown واقعی را پوشش می‌دهد.
آیا جای‌گذاری Markdown از منبعی که کاملاً به آن اعتماد ندارم امن است؟
بله. هر کاراکتری که تایپ یا جای‌گذاری می‌کنید پیش از اعمال هرگونه قالب‌بندی Markdown به‌صورت HTML اسکیپ می‌شود، و آدرس‌های URL پیوندها یا تصاویر پیش از استفاده در برابر فهرست سفید طرح‌واره‌های امن (http، https، mailto و مسیرهای نسبی) بررسی می‌شوند - یک پیوند جای‌گذاری‌شده javascript: یا یک تگ <script> جاسازی‌شده به‌جای اجرا شدن، به‌صورت متن بی‌خطر و قابل مشاهده نمایش داده می‌شود.
تفاوت دانلود HTML و Markdown چیست؟
دانلود Markdown دقیقاً آنچه را که تایپ کرده‌اید به‌صورت یک فایل .md ذخیره می‌کند تا بعداً بیشتر ویرایش شود یا در یک مخزن کامیت گردد. دانلود HTML خروجی رندرشده را به‌صورت یک فایل مستقل .html ذخیره می‌کند که آماده جای‌گذاری در یک CMS، ایمیل یا هر جای دیگری است که HTML نهایی به‌جای کد منبع Markdown انتظار می‌رود.
چرا خطوط جدید من در پیش‌نمایش از بین رفتند؟
این تجزیه‌گر از قوانین استاندارد پاراگراف در Markdown پیروی می‌کند: خطوطی که با یک خط خالی از هم جدا نشده باشند در یک پاراگراف با هم ترکیب می‌شوند و هر شکست خط به یک فاصله واحد تبدیل می‌شود. اگر پاراگراف جدیدی می‌خواهید، بین بلوک‌های متن یک خط خالی بگذارید - فقط یک بار فشردن Enter شکستی قابل مشاهده در خروجی نهایی ایجاد نمی‌کند.
آیا بلوک کد از هایلایت نحوی برای زبانی مانند ```js پشتیبانی می‌کند؟
هنوز نه - زبانی که پس از سه بک‌تیک ابتدایی می‌نویسید فقط برای مشخص کردن محل شروع بلوک استفاده می‌شود و کنار گذاشته می‌شود، نه نمایش داده و نه رنگ‌آمیزی می‌شود. هر چیزی داخل این محصوره اسکیپ می‌شود و به‌صورت متن ساده تک‌فاصله‌ای نمایش داده می‌شود، بنابراین کد شما دقیقاً همان‌طور که تایپ شده باقی می‌ماند، فقط بدون رنگ‌آمیزی نحوی.
آیا از جداول پشتیبانی می‌کند؟
هنوز نه - این تجزیه‌گر روی نحوی که مردم بیشتر از آن استفاده می‌کنند تمرکز دارد، و جداول جداشده با خط عمودی جزو آن مجموعه نیستند. جدولی که با نحو Markdown نوشته شود، به‌جای یک جدول واقعی، به‌صورت متن پاراگراف ساده نمایش داده می‌شود، بنابراین در حال حاضر اگر جدول در خروجی صادرشده لازم دارید، باید آن را مستقیماً به HTML بنویسید.
آیا فهرست‌های تودرتو پشتیبانی می‌شوند؟
خیر - صرف‌نظر از فاصله‌های ابتدایی، هر آیتم فهرست به‌صورت تخت در نظر گرفته می‌شود، بنابراین تورفتگی دادن به یک خط برای ایجاد زیرفهرست، فهرست تودرتو ایجاد نمی‌کند؛ در عوض به‌صورت یک آیتم دیگر در سطح بالا نمایش داده می‌شود. اگر به سلسله‌مراتب نیاز دارید، نزدیک‌ترین راه‌حل جایگزین این است که آن را با عنوان‌ها یا تورفتگی دستی درون یک بلوک کد بنویسید.
آیا استفاده از * یا _ برای پررنگ و مورب فرقی می‌کند؟
خیر - هر دو یکسان در نظر گرفته می‌شوند. **پررنگ** و __پررنگ__ هر دو متن پررنگ تولید می‌کنند، و *مورب* و _مورب_ هر دو متن مورب تولید می‌کنند. دکمه‌های B و I در نوار ابزار همیشه شکل ستاره‌دار را وارد می‌کنند، اما تایپ کردن شکل خط زیر به همان شکل کار می‌کند.
آیا می‌توانم متن را با ~~این‌طور~~ خط بزنم؟
در حال حاضر خیر - خط‌خوردگی بخشی از نحوی نیست که این تجزیه‌گر تشخیص می‌دهد، بنابراین ~~متن~~ به‌جای متن خط‌خورده، به‌صورت واقعی همراه با علامت‌های تیلد در اطراف متن ساده نمایش داده می‌شود. این یکی از رایج‌ترین افزونه‌های فراتر از Markdown اصلی است که این ابزار هنوز پوشش نمی‌دهد.
راه‌های مختلف نوشتن یک خط افقی چیست؟
سه یا تعداد بیشتری خط تیره، ستاره یا زیرخط در یک خط جداگانه - ---، *** یا ___ - همگی به‌صورت یک خط افقی نمایش داده می‌شوند. دکمه ― در نوار ابزار همیشه شکل خط‌تیره را وارد می‌کند، اما اگر خودتان آن‌ها را تایپ کنید هر سه به یک شکل کار می‌کنند.
آیا یک نقل‌قول می‌تواند چند پاراگراف را در بر بگیرد؟
هر بلوک از خطوط پیاپی > درست مانند پاراگراف‌های معمولی، با شکست‌های خط که به فاصله تبدیل می‌شوند، به‌صورت یک پاراگراف واحد درون نقل‌قول نمایش داده می‌شود. باقی گذاشتن یک خط نقل‌قول خالی برای شروع پاراگراف دوم درون همان نقل‌قول پشتیبانی نمی‌شود - در عوض نقل‌قول را پایان می‌دهد.
آیا می‌توانم متن قالب‌بندی‌شده از Word یا Google Docs جای‌گذاری کنم؟
می‌توانید در ویرایشگر جای‌گذاری کنید، اما فقط به‌صورت متن ساده - مرورگرها هنگام جای‌گذاری در یک کادر متن ساده، قالب‌بندی غنی (پررنگ، عنوان‌ها، پیوندها) را حذف می‌کنند، بنابراین کلمات باقی می‌مانند اما قالب‌بندی به‌طور خودکار به نحو Markdown تبدیل نمی‌شود. باید عنوان‌ها، پررنگ‌ها و پیوندها را خودتان دوباره اعمال کنید، و دکمه‌های نوار ابزار بالای ویرایشگر دقیقاً برای همین کار هستند.
دکمه‌های بالای ویرایشگر چه کاری انجام می‌دهند؟
هر کدام نحو Markdown متناظر را در محل نشانگر شما وارد می‌کند، یا آن را دور متنی که انتخاب کرده‌اید قرار می‌دهد - روی B با یک کلمه انتخاب‌شده کلیک کنید، به **کلمه** تبدیل می‌شود؛ روی H2 در یک خط خالی کلیک کنید، به یک عنوان تبدیل می‌شود. این‌ها میان‌بری برای همان نحو دقیقی هستند که این تجزیه‌گر می‌فهمد، نه یک سیستم قالب‌بندی جداگانه.
آیا محدودیتی برای مقدار متنی که می‌توانم جای‌گذاری کنم وجود دارد؟
محدودیت ثابتی وجود ندارد، اما کل سند با هر بار فشردن کلید، به‌طور کامل و از ابتدا، درون رشته اصلی مرورگر شما دوباره تجزیه می‌شود. این کار برای یادداشت‌ها و مقاله‌ها فوری است، اما یک سند بسیار بزرگ (ده‌ها هزار خط) ممکن است هنگام تایپ کمی کند به نظر برسد، زیرا تجزیه افزایشی یا در پس‌زمینه وجود ندارد.
آیا این برای زبان‌های راست‌به‌چپ مانند عربی یا فارسی هم به همین شکل کار می‌کند؟
بله - چیدمان صفحه برای این زبان‌ها به راست‌به‌چپ تغییر می‌کند، و پیش‌نمایش رندرشده نیز همان جهت را دنبال می‌کند، به‌طوری که عنوان‌ها، فهرست‌ها و پاراگراف‌ها به‌طور طبیعی خوانده می‌شوند. خود نحو Markdown (#، *، > و غیره) صرف‌نظر از زبان دقیقاً یکسان باقی می‌ماند.
برای توسعه‌دهندگان: این صفحه را با یک پارامتر `q` در URL باز کنید - مثلاً gizke.com/markdown?q=# Hello world - و آن مقدار به‌طور خودکار از پیش پر می‌شود. اکثر بازدیدکنندگان به این نیاز نخواهند داشت؛ این ویژگی برای پیوند دادن مستقیم به یک نمونه آماده استفاده در نظر گرفته شده است.