Markdown روشی برای نوشتن متن ساختاریافته با نشانه‌های ساده است: عنوان، فهرست، پیوند و بلوک کد را در فایل متنی می‌نویسید و نمایشگر آن‌ها را قالب‌بندی می‌کند. اگر از هوش مصنوعی خروجی Markdown می‌خواهید، باید گویش مقصد را هم مشخص کنید؛ جدول یا قابلیت یک برنامه الزاماً در همهٔ نمایشگرها یکسان نیست.
اولین سند را با چند بخش روشن بسازیم
فایل تمرین پایین صفحه یک سند اصیل دربارهٔ ثبت درخواست است. محتوای آن آموزشی است و سیاست سازمان واقعی نیست. یک عنوان اصلی، چهار عنوان بخش، فهرست شماره‌دار، فهرست ساده، نقل‌قول، کد و یک جدول نمونه دارد. پسوند دانلود TXT است تا بدون ابزار اضافه باز شود؛ برای استفاده در ویرایشگر پشتیبان Markdown می‌توانید یک کپی با پسوند MD ذخیره کنید.
# تمرین ثبت درخواست
این سند **نمونهٔ آموزشی** است.
## مراحل
1. موضوع را ثبت کنید.
2. مسئول اقدام بعدی را مشخص کنید.
## موارد نامعلوم
- زمان حل نهایی را حدس نزنید.
- مقدار نامعلوم را `نامشخص` بگذارید.# در آغاز خط، عنوان سطح اول و ## عنوان سطح دوم می‌سازد. تعداد # را با اندازهٔ دلخواهِ قلم جایگزین نکنید؛ سطح عنوان، ساختار سند است. خط خالی بین بخش‌ها، خواندن و انتقال متن را قابل پیش‌بینی‌تر می‌کند. Bold برای تأکید است؛ جای عنوانِ بخش را نمی‌گیرد.
کد را از متن اجرایی جدا کنیم
کد را میان دو خط دارای سه backtick قرار دهید. پس از خط آغاز می‌توانید نام زبان، مثل python، را بنویسید. در نمونه، خط # این خط عنوان سند نیست داخل بلوک کد است و نباید عنوان تازهٔ مقاله شود. نمایش بلوک کد به معنی اجرای آن نیست؛ برنامهٔ نمایش‌دهنده معمولاً فقط متن را قالب می‌دهد.
وقتی پاسخ دستیار را کپی می‌کنید، مطمئن شوید خط بسته‌شدن بلوک حذف نشده باشد؛ وگرنه ممکن است بخش‌های بعدی هم کد نمایش داده شوند. اگر داخل کد خودتان سه backtick دارید، حصار بیرونی بلندتر و سازگار با نمایشگر انتخاب کنید. همهٔ پاسخ را در یک بلوک کد نگذارید، مگر واقعاً می‌خواهید منبع خام Markdown را نشان دهید.
جدول به گویش مقصد بستگی دارد
| فیلد | مقدار نمونه |
| --- | --- |
| مسئول | نامشخص |
| اقدام بعدی | بررسی |این جدول، نحو GFM یا GitHub Flavored Markdown است؛ جدولِ لوله‌ای بخشی از هستهٔ CommonMark نیست. در بررسی محلی همین فایل با کتابخانهٔ موجود Marked، با gfm=true جدول HTML ساخته شد و با gfm=false ساخته نشد. این آزمون فقط پیکربندی اعلام‌شده را بررسی کرده و وعدهٔ نمایش یکسان در همهٔ ویرایشگرها نیست.
برای جدول پهن یا متن چندخطی، پیش‌نمایش مقصد و عرض موبایل را بررسی کنید. اگر مقصد جدول را نمی‌فهمد، فهرست «نام فیلد: مقدار» می‌تواند خواناتر باشد. جدول داده را با چند فاصلهٔ دستی هم‌تراز نکنید؛ قلم و عرض صفحه می‌تواند آن را به‌هم بریزد.
پیوند، تصویر و HTML خام چه فرقی دارند؟
پیوند به شکل [متن](نشانی) نوشته می‌شود. تصویر با ! پیش از همان الگو شروع می‌شود و متن داخل کروشه نقش توضیح تصویر را دارد؛ فایل تصویر باید واقعاً موجود و مجاز باشد. خود Markdown عکس را تولید نمی‌کند. حمایت از HTML خام نیز به برنامه و سیاست پاک‌سازی آن وابسته است؛ خروجی مبدل را بدون بررسی مستقیم وارد صفحهٔ عمومی نکنید.
در این نمونه HTML خام، فایل شخصی یا تصویر خارجی نداریم. نتیجهٔ JSON همراه، یک عنوان اصلی، چهار عنوان بخش، کد، جدول GFM و پیوند معتبرِ نحوی را ثبت می‌کند. کد داخل سند برای نمایش است و در آزمون ساختار اجرا نشده است.
دستور روشن برای خروجی دستیار
یک سند Markdown با یک H1 و بخش‌های H2 بساز. گویش مقصد GFM است. کدها در حصار بسته و جدول دو ستونی باشد. دادهٔ نامعلوم را حدس نزن و پیوند یا تصویر ناموجود نساز. متن آموزشی را با دستور اجرایی برنامه یکی نکن.
این مهارت دربارهٔ نوشتن سند است؛ قطعه‌بندی سند برای RAG مرحلهٔ پردازش و بازیابیِ بعدی را بررسی می‌کند. برای ادامهٔ مبانی ابزارها، راهنمای هوش مصنوعی را ببینید.
فایل تمرین و منبع
سند نمونهٔ Markdown؛ TXT قابل تغییر نام به MD · ساختار مورد انتظارِ نمونه و نتیجهٔ بررسی Marked
منابع در ۳ نوامبر ۲۰۲۶ خوانده شدند؛ این تاریخ، تاریخ انتشار منبع نیست. مثال‌ها و فایل‌های این راهنما آموزشی و ساختهٔ تحریریه‌اند.