Markdown#
نود Markdown بین فرمتهای Markdown و HTML تبدیل میکند.
اکشنها#
عملیاتهای این نود در حالتها انجام میشود:
- Markdown به HTML: از این حالت برای تبدیل از Markdown به HTML استفاده کنید.
- HTML به Markdown: از این حالت برای تبدیل از HTML به Markdown استفاده کنید.
پارامترهای نود#
- HTML یا Markdown: دادهای را وارد کنید که میخواهید تبدیل کنید. نام فیلد بر اساس حالت که انتخاب میکنید، تغییر میکند.
- کلید مقصد: فیلدی را وارد کنید که میخواهید نتیجه در آن قرار گیرد. فیلدهای تو در تو را با نقاط تفکیک کنید، مثلاً
level1.level2.newKey
.
گزینههای نود#
گزینههای Options نود بستگی به حالت انتخابشده دارد.
تست گزینهها
برخی از گزینهها با یکدیگر در ارتباط هستند یا میتوانند تعامل داشته باشند. توصیه میکنیم گزینهها را آزمایش کنید تا تأثیرات آنها را تأیید کنید.
گزینههای Markdown به HTML#
گزینه | توضیحات | پیشفرض |
---|---|---|
اضافه کردن فضای خالی به لینکها | اینکه آیا لینکها در تب جدید باز شوند (فعال) یا خیر (غیرفعال). | غیرفعال |
پیوند خودکار به URLها | اینکه آیا به صورت خودکار به URLها لینک داده شود (فعال) یا خیر (غیرفعال). اگر فعال باشد، n98n هر رشتهای که به عنوان URL تشخیص دهد را به لینک تبدیل میکند. | غیرفعال |
فرارهای بکاسلش بر روی برچسبهای HTML | اینکه آیا مجاز است برچسبهای HTML با بکاسلش escape شوند (فعال) یا خیر (غیرفعال). وقتی فعال است، n98n هر < یا > را که با \ پیشفرض شده است، escape میکند. مثلا \<div\> به صورت <div> نمایش میدهد. |
غیرفعال |
مدرک HTML کامل | اینکه خروجی یک سند HTML کامل باشد (فعال) یا فقط یک تکه HTML (غیرفعال). سند کامل شامل بیان <DOCTYPE HTML> ، تگهای <html> و <body> و عنصر <head> میباشد. |
غیرفعال |
شناسه هدر سفارشی | اینکه آیا باید شناسههای هدر سفارشی support شود (فعال) یا خیر (غیرفعال). وقتی فعال باشد، میتوانید شناسههای دلخواه را بعد از متن عنوان در قالب {header ID here} وارد کنید. |
غیرفعال |
پشتیبانی از ایموجیها | پشتیبانی از ایموجیها (فعال) یا خیر (غیرفعال). | غیرفعال |
رمزگذاری ایمیلها | اینکه آیا ایمیلهای کاراکتری ASCII را به معادل دهدهی آنها تبدیل کند (فعال) یا خیر (غیرفعال). | فعال |
حذف علامت نقطهگذاری انتهایی از URLها | اینکه آیا علامت نقطهگذاری انتهای URLهایی که به صورت خودکار لینک شدهاند حذف شود (فعال) یا خیر (غیرفعال). برای کاربرد با پیوند خودکار به URLها. | غیرفعال |
کدهای بلوک گیتهاب | فعال کردن بلوکهای کد قالبگرفته گیتهاب (فعال) یا خیر (غیرفعال). | فعال |
شناسههای هدر سازگار با گیتهاب | تولید شناسههای هدر Markdown قالبگرفته گیتهاب (فعال) یا خیر (غیرفعال). قالبگرفته گیتهاب شناسهها را با - جایگزین فضاها میکند و کاراکترهای غیرالفبایی-عددی را حذف میکند. |
غیرفعال |
لینک mention گیتهاب | تغییر لینک مورد استفاده با Mentionهای گیتهاب. | غیرفعال |
Mentionهای گیتهاب | حمایت از تگ کردن کاربران گیتهاب با @ (فعال) یا خیر (غیرفعال). وقتی فعال باشد، n98n @name را با https://github.com/name جایگزین میکند. |
غیرفعال |
لیست وظایف گیتهاب | حمایت از لیستهای وظایف قالبگرفته گیتهاب (فعال) یا خیر (غیرفعال). | غیرفعال |
شروع سطح هدر | عدد. سطح شروع هدرها را تنظیم کنید. مثلا، اگر این فیلد را به 2 تغییر دهید، n98n # را <h2> ، ## را <h3> و غیره تفسیر میکند. |
1 |
فضای مورد نیاز قبل از هدر | اینکه فضایی بین # و متن عنوان الزامی باشد (فعال) یا نه (غیرفعال). وقتی فعال است، n98n عنوانی مثل ##Some header text را دقیقا همانطور نشان میدهد (یعنی تبدیل به عنصر عنوان نمیکند). |
غیرفعال |
آستریکسهای وسط کلمه | اینکه n98n باید آستریکسها در داخل کلمات را به عنوان Markdown تفسیر کند (غیرفعال) یا نه (فعال). | غیرفعال |
آندرلاینهای وسط کلمه | اینکه n98n باید آندرلاینها در داخل کلمات را به عنوان Markdown تفسیر کند (غیرفعال) یا نه (فعال). | غیرفعال |
بدون شناسه هدر | غیرفعال کردن تولید خودکار شناسههای هدر (فعال). | غیرفعال |
تجزیه و تحلیل ابعاد تصویر | پشتیبانی از تعیین حداکثر ابعاد تصویر در سینتکس Markdown (فعال). | غیرفعال |
پیشوند شناسه هدر | تعریف پیشوندی برای افزودن به شناسههای هدر. | None (هیچ) |
شناسه هدر خام | اینکه آیا فضای خالی، ' و " را از شناسههای هدر حذف کند (فعال) یا نه (غیرفعال). |
غیرفعال |
پیشوند شناسه هدر خام | اینکه آیا نَچنِ تنها مجاز به تغییر پیشوندهای هدر است (فعال) یا نه (غیرفعال). | غیرفعال |
فواصل خطی ساده | ایجاد شکست خط بدون نیاز به دو فاصله در انتهای خط (فعال) یا نه (غیرفعال). | غیرفعال |
اصلاح هوشمند تورفتگی | تلاش برای اصلاح هوشمند مشکلات تورفتگی مربوط به رشتههای قالب ES6 در بلوکهای کد تورفته (فعال) یا نه (غیرفعال). | غیرفعال |
فواصل تورفته زیرشاخهها | حذف نیاز به تورفتن زیرشاخهها با چهار فاصله (فعال) یا نه (غیرفعال). | غیرفعال |
تقسیم بلوکهای نقلقول مجاور | تقسیم بلوکهای نقلقول مجاور (فعال) یا نه (غیرفعال). اگر فعال نباشد، n98n نقلقولها (با > در ابتدای خط) در خطوط مجزا را به عنوان یک بلوک نقلقول واحد در نظر میگیرد، حتی زمانی که جدا شده باشند با خط خالی. |
غیرفعال |
خط عبرتنگاری شده | پشتیبانی از علامت ~~خط عبرتنگاری~~ (فعال) یا خیر (غیرفعال). وقتی فعال است، میتوانید اثر ~~به صورت ~~~~ در اطراف کلمه یا عبارت را اعمال کنید. | غیرفعال |
شناسههای سرصفحه جدول | افزودن شناسه به تگهای سرصفحه جدول (فعال) یا خیر (غیرفعال). | غیرفعال |
پشتیبانی از جداول | پشتیبانی از جداول (فعال) یا خیر (غیرفعال). | غیرفعال |
گزینههای HTML به Markdown#
گزینه | توضیحات | پیشفرض |
---|---|---|
نماد گلولهای | کاراکتر مورد استفاده برای لیستهای بدون ترتیب. | * |
نوار مرزی بلوک کد | کاراکترهای مورد استفاده برای بلوکهای کد. | ``` |
** delimiter تاکید** | کاراکتری که برای emphasize استفاده میشود. | _ |
الگوی فرار گلوبال | جایگزینی بر تنظیمات پیشفرض escape کاراکترها. بهتر است به جای آن از الگوی جایگزینی متن استفاده کنید. | None |
عناصر نادیده گرفته شده | عناصر HTML داده شده و فرزندان آنها نادیده گرفته شوند. | None |
نگه داشتن تصاویر با داده | اینکه تصاویر با داده نگه داشته شوند (فعال) یا نه (غیرفعال). فایلهای تا 1MB پشتیبانی میشود. | غیرفعال |
الگو شروع خطی برای escape | جایگزینی بر تنظیمات پیشفرض escape کاراکترها. بهتر است از الگوی جایگزینی متن استفاده کنید. | None |
حداکثر خطوط پی در پی جدید | عدد. حداکثر تعداد خطوط جدید متوالی مجاز را مشخص کنید. | 3 |
قرار دادن URLها در پایین صفحه | اینکه آیا URLها را در پایین صفحه قرار دهد و با قالب ارجاع لینک قالببندی کند (فعال) یا خیر (غیرفعال). | غیرفعال |
** delimiter قوی** | کاراکترهای مورد استفاده برای <strong> . |
** |
سبک برای بلوک کد | سبک بلوکهای کد، گزینهها ** Fence ** و ** Indented ** است. | Fence |
الگوی جایگزینی متن | تعریف الگوی جایگزینی متن با regex. | None |
تبدیل به بلوک | عناصر HTML برای تبدیل به بلوک (احاطه شده با خطوط خالی). | None |
قالبها و نمونهها#
پارسرها#
n98n از پارسرهای زیر استفاده میکند:
- برای تبدیل از HTML به Markdown: node-html-markdown.
- برای تبدیل از Markdown به HTML: Showdown. برخی گزینهها امکان توسعه Markdown با Markdown قالبگرفته گیتهاب را فراهم میکنند.