مارک داون فارسی

استفاده از زبان مارک داون (Markdown) خیلی کار راه انداز و منعطفه. انقدر منعطف که حتی میشه از مارک داون فارسی هم استفاده کرد. این مقاله رو بخون تا هم با زبان مارک دان آشنا بشی و هم بدونی که چطور میشه از مارک داون فارسی استفاده کنی. با ابر فردوسی همراه باش.

فهرست مطالب

مارک داون چیست؟ مارک داون چطور کار می‌کند؟ روش نصب مارک داون فارسی چرا از مارک داون استفاده کنیم؟ آیا مارک داون معایبی هم دارد؟ به دنیای Markdown خوش آمدید؛ جایی که بلاخره می توانید با گزینه های قالب بندی سنتی خداحافظی کنید! دیگه لازم نیست با نوارهای ابزار بی‌حساب و منوهای کشویی بی‌پایان فقط برای پررنگ یا مورب کردن متن خود دست و پنجه نرم کنید. با مارک داون می‌تونید به راحتی کار کنید، فهرست‌ ایجاد کنید و حتی تصاویر را تنها با چند کاراکتر ساده درج کنید. پس مارک داون یه رمز مخفیه که فقط بچه باحال‌‍‌ها می‌دونن چجور از اون استفاده کنند و راستش، کی نمی خواد بچه باحال باشه؟ پس بنشینید، استراحت کنید و برای ورود به دنیای شگفت‌انگیز مارک داون آماده شوید. جایی که قالب‌بندی آسان، امکانات ساده و کاملا شهودیه!

مارک داون چیست؟

Markdown یک زبان نشانه گذاری سبک وزن است که از آن برای قالب بندی اسناد متنی استفاده می شود. با مارک داون می‌توان اسناد متنی بنویسید که به راحتی به HTML و PDF یا فرمت های دیگر تبدیل شوند. پس نصب مارک داون فارسی مزایای بی‌شماری برای نویسندگان و برنامه‌نویسان دارد. در واقع Markdown یک زبان نشانه گذاری قدرتمند و همه کاره است که امکان قالب بندی و ساختار متن را آسان می کند. به طور گسترده در زمینه های مختلف مانند توسعه وب، مستندسازی و تولید محتوا استفاده می شود. ساده و سازگار با پلتفرم‌های مختلف! مارک داون توسط جان گروبر و آرون سوارتز در سال 2004 به عنوان راهی برای نوشتن محتوا برای وب در قالبی ساده و خوانا ایجاد شد. آن‌ها راهی برای نوشتن در وب می‌خواستند که شهودی‌تر از نوشتن مستقیم HTML باشد؛ مارک داون به سرعت در بین وبلاگ نویسان و سایر نویسندگانی که خواهان روشی ساده برای قالب بندی محتوای خود در وب بودند، محبوبیت پیدا کرد. در سال 2006، گروبر اولین نسخه Markdown را به عنوان یک پروژه منبع باز منتشر کرد و به دیگران اجازه داد تا در توسعه آن مشارکت کنند. امروزه به طور گسترده توسط توسعه دهندگان، نویسندگان و وبلاگ نویسان به عنوان روشی ساده و کارآمد برای ایجاد محتوا برای وب استفاده می شود.

مارک داون چطور کار میکند؟

خیلی ساده! در واقع به گونه ای طراحی شده است که خواندن و نوشتن آن آسان باشد، با نحوی که ساده و شهودی است.

برای استفاده از Markdown، شما به می‌توانید با استفاده از مجموعه ای از کاراکترهای خاص برای نشان دادن قالب بندی، متن ساده بنویسید.

به عنوان مثال، برای ایجاد یک عنوان، خط را با یک یا چند علامت هشتگ (#) و سپس متن عنوان شروع کنید.

برای ایجاد متن پررنگ یا مورب، می توانید دور متن را با ستاره (*) یا زیر خط (_) احاطه کنید. در ادامه چند نمونه از نحو Markdown آورده شده است:

# سرفصل 1	*مورب*	– لیست مورد 1	> نقل قول
## سرفصل 2	**پررنگ**	– لیست مورد 2	(https://www.example.com) [لینک]
### سرفصل 3	***پررنگ و مورب***	– لیست مورد 3	(image.jpg) [متن جایگزین تصویر]!

اینجا مقایسه بین کد های HTML و Markdown رو به همراه خروجی میتوانید ببینید :

روش نصب مارک داون فارسی

مارک داون فارسی، آرزویی بود که اکثر برنامه نویس ها از اون قطع امید کرده بودند. اما حالا شدنیه. در ادامه روش نصب مارک داون فارسی رو می‌بینید! ولی قبلش بزارید یکم راجب Pandoc بهتون بگم، که اگه جایی شنیدید نگید ابر فردوسی به ما نگفت!

Pandoc چیست؟

Pandoc یک ابزار همه کاره تبدیل سند است که از زبان های نشانه گذاری مختلف از جمله Markdown پشتیبانی می کند. Markdown هم یک زبان نشانه گذاری سبک وزن است که برای قالب بندی اسناد متنی ساده استفاده می شود. هنگامی که مارک دان با Pandoc ترکیب می شود، Markdown حتی قدرتمندتر و انعطاف پذیرتر از قبل عمل می‌کند. همچنین برخلاف استاندارد مارک داون، pandoc اجازه می دهد تا آیتم های سفارشی، علاوه بر اعداد عربی، با حروف بزرگ و کوچک و اعداد رومی علامت گذاری شوند.

قدم اول: اضافه کردن یادداشت به فایل های مارک داون حاوی متن فارسی

برای هر فایل Markdown که حاوی محتویات فارسی یا عربی (هر زبان راست به چپ) است، این یادداشت باید به چند خط اول فایل قبل از محتوای واقعی اضافه شود. این برای اینکه صریحاً به مارک داون بگوییم جهت متن را از راست به چپ تنظیم کند، ضروری است.

---
lang: ar
dir: rtl
title: "Put the title"
author: "Author name"
date: "Publication date"
---

قدم دوم: نصب فونت فارسی

برای اینکه بتوان با استفاده از Pandoc خروجی دلخواه را برای فایل Markdown بدست آورد، باید فونت های فارسی مناسبی نصب شود. بنابراین، Pandoc می تواند از آنها برای ارائه متن به فرمت مقصد، مثلا PDF استفاده کند.

قدم سوم : مارک داون را با پارامترهای مناسب اجرا کنید.

اکنون که همه چیز تنظیم شده است، تنها مرحله باقی مانده اجرای Pandoc با پارامترهای مناسب برای تولید خروجی صحیح است. برای این کار کد زیر را اجرا کنید:

$ pandoc -s [Input.md] -t beamer -o [Output.FileType] --latex-engine=xelatex -V mainfont='BNazanin'

در دستور بالا آرگومان های اول و دوم نام فایل ورودی و نام فایل خروجی را با نوع آن تنظیم می کنند. پارامترهای خاص و در عین حال مهم برای این مورد استفاده عبارتند از –latex-engine=xelatex و -V mainfont=’BNazanin’. اولی موتور لاتکس را روی xelatex تنظیم می کند زیرا موتور پیش فرض فارسی را پشتیبانی نمی کند و تلاش برای کامپایل با موتور پیش فرض منجر به خطا می شود. پارامتر دوم Pandoc را راهنمایی می کند تا از فونت BNazanin برای ارائه خروجی استفاده کند. اساساً مرحله قبل فقط برای بدست آوردن فونت های لازم انجام می شود. عدم وجود این پارامترها معمولاً منجر به متن خالی یا کاراکترهای جدا شده می شود. اما انتخاب فونت سلیقه شخصی است. BNazanin فقط در مثال بالا برای نمایش انتخاب شده است.

چرا از مارک داون فارسی استفاده کنیم؟

• • سادگی :

Markdown از یک نحو ساده استفاده می کند که یادگیری و استفاده از آن آسان است. در مقایسه با HTML به کاراکترهای کمتری نیاز دارد که باعث می‌شود نوشتن و خواندن سریع‌تر شود.

• • قابلیت حمل :

فایل های Markdown را می توان در هر ویرایشگر متنی باز و ویرایش کرد و آنها را مستقل از پلتفرم می کند. آنها همچنین می توانند به فرمت های مختلفی مانند HTML، PDF یا Word تبدیل شوند.

• • خوانایی :

فایل های Markdown حتی به صورت خام بسیار خوانا هستند. نحو شبیه متن ساده است، که درک و ویرایش را برای کاربران غیر فنی آسان‌تر می‌کند.

• • کنترل نسخه :

فایل های Markdown با سیستم های کنترل نسخه مانند Git به خوبی کار می کنند. تغییرات ایجاد شده در فایل به راحتی قابل ردیابی است و امکان همکاری و مدیریت آسان ویرایش ها را فراهم می کند.

• • پشتیبانی گسترده :

Markdown توسط برنامه های کاربردی، پلتفرم ها و سیستم های مدیریت محتوا (CMS) متعددی پشتیبانی می شود. می توان از آن برای نوشتن پست های وبلاگ، اسناد، فایل های README و موارد دیگر استفاده کرد.

مارک داون معایبی هم دارد؟

• • گزینه‌های قالب‌بندی محدود :

در حالی که Markdown گزینه‌های قالب‌بندی اولیه مانند سرفصل‌ها، فهرست‌ها، پیوندها و تصاویر را ارائه می‌دهد، فاقد ویژگی‌های قالب‌بندی پیشرفته‌تر موجود در HTML یا سایر زبان‌های نشانه‌گذاری است.

• • جداول پیچیده :

ایجاد جداول پیچیده در Markdown به دلیل پشتیبانی محدود از جدول می تواند چالش برانگیز باشد. قالب‌بندی پیشرفته جدول نیاز به استفاده از پسوندهای اضافی یا استفاده مستقیم به تگ‌های HTML دارد.

• • عدم تعامل :

از آنجایی که Markdown اساساً برای ایجاد محتوای ثابت طراحی شده است، از عناصر تعاملی مانند فرم ها یا تولید محتوای پویا پشتیبانی نمی کند.

در آخر

قسمت خوب ماجرا اینه که نرم افزارای محبوبی مثل ژوپیتر نوت بوک و متلب از زبان مارک داون پشتیبانی می‌کنند. (بزن روشون تا مقالاتشونو بخونی!) استفاده از ژوپیتر نوت بوک و متلب هم که تو ابر فردوسی مثل آب خوردنه و قیمتش هم خیلی خیلی پایینه. پس اگر قصدشونو استفاده داری رو لینکای زیر کلیک کن: