.\" Copyright (c) Kristaps Dzonsons .\" Copyright (c) 2017 Christina Sophonpanich .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd $Mdocdate$ .Dt LOWDOWN 5 .Os . . .Sh "نام (NAME)" .Nm lowdown .Nd قالب پرونده Markdown برای ابزار lowdown . . .Sh "توضیحات (DESCRIPTION)" قالب Markdown یک زبان قالب‌بندی متنی ساده و سرراست (plain-text) است. .Dq متن ساده در اینجا بدین معناست که ورودی سند بسیار شبیه به خروجی نهایی به نظر می‌رسد، بدون در نظر گرفتن ظرافت‌های قالب‌بندی (جداول قاب‌دار، حروف کج، پیوندهای قابل کلیک و غیره) که توسط محیط خروجی ارائه می‌شوند. برای نمونه: .Bd -literal -offset indent # How to be a Picard fan ## Introduction In order to develop fandom skills one must first and foremost know *whom* one idolises. Therefore: **who is Captain Picard**? 1. Picard was named the \e*Best Star Trek Captain\e*, according to a [5-week poll](poll.html). > Picard continued his winning ways in the final week, > with fans naming him the most inspiring captain. 2. Picard is handsome. ![Picard](image.jpg) 3. Picard knows how to code: `make engage` --------------------------------- ## Picard Fandom Here's why everyone wants to be a fan... .Ed .Pp این مثال از مجموعه‌ای از عناصر بلوکی تشکیل شده است: سرآیند بخش، سرآیند زیربخش، بند (پاراگراف)، مجموعه‌ای از موارد فهرست، خط افقی، و سپس سرآیند زیربخش دیگر. هر عنصر بلوکی شامل عناصر درون‌خطی است: متن عادی، متن تاکیدشده (توپر و کج)، تصویر، پیوند، و بخشی از کد. .Pp این سند ساختار دستوری Markdown پذیرفته‌شده توسط .Xr lowdown 1 را شرح می‌دهد. . . .Sh "متن (TEXT)" متن درون اسناد Markdown باید با کدگذاری UTF-8 باشد. سند می‌تواند حاوی علامت ترتیب بایت (BOM) باشد، هرچند این کار توسط استاندارد یونیکد توصیه نمی‌شود. خطوط متنی می‌توانند با پایان خط یونیکس .Pq Sq \en یا داس .Pq Sq \er\en خاتمه یابند. در حالت دوم، چنانچه بازگشت به ابتدای خط (carriage return) در خط اول شناسایی شود، از کل ورودی حذف خواهد شد. . . .Sh "عناصر بلوکی (BLOCK ELEMENTS)" یک عنصر بلوکی در یک خط جدید آغاز می‌شود و تا خط خالی بعدی یا عنصر بلوکی بعدی ادامه می‌یابد. یک عنصر بلوکی شامل عناصر درون‌خطی است. . .Ss "بندها و شکست‌های خط (Paragraphs and Line Breaks)" یک بند از یک یا چند خط متن تشکیل می‌شود که ممکن است حاوی عناصر درون‌خطی باشند. بندها با خطوط خالی از یکدیگر جدا می‌شوند. .Pp برای درج یک شکست خط سخت (یعنی شکست خطی در ورودی که عیناً در خروجی بازتولید شود)، دو فاصله در انتهای خط قرار دهید. اگر تجزیه‌کننده ورودی commonmark فعال باشد، این کار می‌تواند با گریز دادن خط جدید نیز انجام شود: .Bd -literal -offset indent Darmok and Jalad...\e at Tanagra. .Ed . .Ss "سرآیندها (Headers)" دو سبک برای سرآیندها وجود دارد: زیرخط‌دار .Pq Dq setext و علامت‌گذاری‌شده با هش .Pq Dq atx . برای سرآیندهای زیرخط‌دار، کلمه داده‌شده را با علامت مساوی .Pq Dq = برای سرآیندهای سطح اول و خط تیره .Pq Dq \&- برای سرآیندهای سطح دوم خط بکشید. .Bd -literal -offset indent This is an underlined header 1 ============================== .Ed .Pp برای سرآیندهای علامت‌گذاری‌شده با هش، از تعداد نویسه‌های هش متناظر با سطح سرآیند (تا ۶ سطح) در ابتدای خط استفاده کنید که با یک فاصله از متن سرآیند جدا می‌شود. .Bd -literal -offset indent ## This is a hash-marked header 2 .Ed .Pp چنانچه تجزیه‌کننده ورودی commonmark فعال باشد، وجود فاصله پس از نویسه‌های هش در هر سرآیند هش‌دار الزامی است. .Pp هر دو نوع سرآیند از ویژگی‌های PHP Extra درون آکولاد پشتیبانی می‌کنند. این ویژگی‌ها می‌توانند از هر نقطه‌ای شروع شوند اما باید در انتهای خط پایان یابند. .Bd -literal -offset indent ## Star Trek: Enterprise { #stent } Star Trek: Enterprise { .reboots } --------------------- .Ed .Pp مقادیر غیرخالی با نقطه ابتدایی به عنوان کلاس‌های HTML (CSS) یا OpenDocument تفسیر می‌شوند، و مقادیر با علامت پوند (#) ابتدایی به عنوان شناسه‌های پیوند درون‌سندی تفسیر می‌گردند. .Pp شناسه‌های ویژگی Extra سازوکار پیش‌فرض برای ایجاد شناسه‌های سرآیند را بازنویسی می‌کنند. آن‌ها باید تنها شامل نویسه‌های الفبایی-عددی ASCII باشند. . .Ss "نقل‌قول‌های بلوکی (Block Quotes)" بخش‌های نقل‌قول بلوکی با یک علامت زاویه راست .Pq Dq > به همراه یک فاصله در ابتدای هر خط و بین بندها فراخوانی می‌شوند. .Bd -literal -offset indent > The Prime Directive is not just a set of rules; > it is a philosophy... and a very correct one. > > (It goes on for a few paragraphs). .Ed .Pp نقل‌قول‌های بلوکی همچنین می‌توانند فراخوانی غیرچندخطی داشته باشند: کافی است علامت زاویه راست را تنها در ابتدای یک بند درج کنید و آن را بین بندها کاملاً حذف نمایید. .Bd -literal -offset indent > You cannot explain away a wantonly immoral act because you think it is connected to some higher purpose. > Here is another paragraph about Picard wisdom. .Ed .Pp نقل‌قول‌های بلوکی متوالی مانند بالا در خروجی به صورت بندهایی درون یک نقل‌قول بلوکی واحد ادغام می‌شوند، حتی اگر سبک‌ها .Pq غیرچندخطی و غیرازآن ترکیب شده باشند. .Pp نقل‌قول‌های بلوکی می‌توانند درون سایر نقل‌قول‌های بلوکی تو در تو شوند، همان‌طور که هر عنصر بلوکی دیگری مانند سرآیندها، فهرست‌های مرتب/نامرتب، و بلوک‌های کد می‌توانند تو در تو قرار گیرند. .Bd -literal -offset indent > ### hash-marked header 3 > > > I'd be delighted to offer any advice > > I have on understanding women. > > When I have some, I'll let you know. > > 1. advice list item 1 > 2. advice list item 2 > > Here's the code to implement JLP's advice: > yes | read engage .Ed . .Ss "هشدارهای متنی (Admonitions)" این نقل‌قول‌های بلوکی ویژه که به آن‌ها .Qq callouts نیز گفته می‌شود، توجه خواننده را به محتوا جلب می‌کنند. این‌ها معمولاً همان‌طور که هستند رندر می‌شوند، اما برخی حالت‌های خروجی به شکل ویژه‌ای آن‌ها را برای برجسته‌سازی محتوا نمایش می‌دهند. .Bd -literal -offset indent > **Note** > > The computer is voiced by Majel Barrett. .Ed .Pp پیام‌های توجه با یک تاکید دوگانه .Qq Note یا .Qq Warning آغاز می‌شوند، و حذف خط جدید اولیه، فاصله‌های خالی پس از نوع هشدار را نادیده می‌گیرد. این ساختار دستوری GFM است. ساختار دستوری MDN شامل یک عبارت اولیه پس از نوع هشدار و دونقطه است، و همچنین از نوع .Qq Callout پشتیبانی می‌کند: .Bd -literal -offset indent > **Warning:** red alert. > > Romulan warbird decloaking! .Ed . .Ss "فهرست‌ها (Lists)" فهرست‌ها می‌توانند به صورت مرتب (شماره‌گذاری‌شده) یا نامرتب مشخص شوند. فهرست‌های مرتب با اعداد به همراه نقطه .Pq مانند Dq 1. فراخوانی شده و در قالبی مشابه رندر می‌شوند. .Em نکته : مهم نیست از چه ترتیبی یا چه اعدادی در فهرست مرتب خود استفاده می‌کنید، زیرا تمام فهرست‌های مرتب از عدد یک شروع می‌شوند. .Bd -literal -offset indent 1. Make. 2. It. 1. So. (Not 1. again!) .Ed .Pp اگر تجزیه‌کننده ورودی commonmark فعال باشد، موارد فهرست می‌توانند متناوباً با پرانتز راست خاتمه یابند: .Bd -literal -offset indent 1) Live long 2) Prosper .Ed .Pp برای جلوگیری از ایجاد ناخواسته فهرست‌ها توسط بندی که با عدد و نقطه شروع می‌شود، پیش از نقطه از یک ممیز وارونه (backslash) استفاده کنید. .Bd -literal -offset indent 1987. The year TNG premiered. 1987\e. The year TNG premiered. .Ed .Pp از سوی دیگر، فهرست‌های نامرتب می‌توانند با استفاده از ستاره .Pq Dq * , علامت جمع .Pq Dq + , یا خط تیره .Pq Dq \- فراخوانی شوند و می‌توان ترکیبی از هر سه سبک را به کار برد. صرف‌نظر از سبک به‌کاررفته، موارد فهرست به یک شیوه رندر می‌شوند. .Bd -literal -offset indent - Earl Grey tea. * Shakespeare. + Exotic fish. .Ed .Pp تمام عناصر بلوکی تو در تو به یک شکست خط جدید نیاز دارند، در غیر این صورت در خروجی روی همان خط مربوط به مورد فهرست رندر خواهند شد. برای درج بندها در یک مورد فهرست، هر بند را با چهار فاصله یا یک تب تورفتگی دهید. .Bd -literal -offset indent - First list item Courage can be an emotion too. Things are only impossible until they're not. + Second list item + Third list item .Ed .Pp برای درج نقل‌قول‌های بلوکی در یک مورد فهرست، نقل‌قول بلوکی را با چهار فاصله یا یک تب قبل از علامت زاویه راست .Pq Dq > تورفتگی دهید. .Bd -literal -offset indent * List item 1 * List item 2 > I am Locutus of Borg. > That is the cutest of Borg. .Ed .Pp بلوک‌های کد باید دو بار تورفتگی داشته باشند (دو تب یا هشت فاصله ابتدایی): یک بار برای شناخته شدن درون مورد فهرست، و بار دیگر برای خود بلوک کد. .Bd -literal -offset indent * Here is a list item for an indented code block: alias path='echo -e ${PATH//:/\\n}' .Ed .Pp برای اینکه عناصر فهرست به صورت پیوسته و فشرده ظاهر شوند \(em مانند فهرست خرید \(em نباید خط خالی بین موارد وجود داشته باشد. .Bd -literal -offset indent - Phaser - Communicator .Ed .Pp از سوی دیگر، اگر می‌خواهید فهرست‌ها با فاصله خالی رندر شوند، از ساختار دستوری زیر استفاده کنید: .Bd -literal -offset indent - A phaser is a type of weapon. - A communicator keeps Riker in contact with Troi. .Ed .Pp این قاعده برای هر دو نوع فهرست مرتب و نامرتب صدق می‌کند. . .Ss "فهرست‌های وظایف (Task lists)" یکی از اشکال فهرست نامرتب، فهرست وظایف است که یک افزونه GFM به شمار می‌رود. این فهرست‌ها با جعبه‌های علامت‌گذاری (علامت‌خورده یا نخورده) آغاز می‌شوند و در خروجی به شکل مشابهی رندر می‌گردند. .Bd -literal -offset indent Star Trek series with episodes in the Delta quadrant: - [ ] Original series - [x] TNG - [ ] DS9 - [x] Voyager - [ ] Enterprise - [ ] Discovery .Ed .Pp علامت بررسی می‌تواند با حروف بزرگ یا کوچک باشد. یک فاصله باید پس از قلاب راست قرار گیرد. . .Ss "فهرست‌های تعاریف (Definition Lists)" فهرست‌های تعاریف یک افزونه PHP Extra هستند. آن‌ها شبیه به فهرست‌ها هستند با این تفاوت که جفت‌های کلید و مقدار دارند، و کلیدها با یک خط خالی مقدم می‌شوند: .Bd -literal -offset indent Best understated characters: *Quark* : Armin Shimerman *Weyoun* : Jeffrey Combs .Ed .Pp کلیدها از یک خط تشکیل می‌شوند و می‌توانند شامل عناصر درون‌خطی باشند. مانند سایر فهرست‌ها، مقادیر می‌توانند شامل بلوک‌های تو در توی دلخواه باشند. برای هر کلید می‌تواند چندین مقدار متوالی وجود داشته باشد. اگر کلید و مقدار با یک خط خالی از هم جدا شوند، فهرست به گونه‌ای تولید می‌شود که گویی حاوی عناصر بلوکی است (معمولاً در خروجی به صورت فاصله بین جفت‌های کلید-مقدار نمایش می‌یابد). . .Ss "بلوک‌های کد (Code Blocks)" بلوک‌های کد شامل متن پیش‌قالب‌بندی‌شده مانند کد منبع هستند. هر بلوک کد شامل متنی کدر/لفظی (opaque/literal) است. این بدان معناست که خطوط جدید و فاصله‌های خالی حفظ می‌شوند \(em به هیچ وجه قالب‌بندی نمی‌شوند و هر متنی درون بلوک کد تفسیر نمی‌گردد. برای فراخوانی یک بلوک کد، یک شکست خط ایجاد کرده و سپس هر خط را با چهار فاصله یا یک تب تورفتگی دهید. .Bd -literal -offset indent Here is a paragraph about Bridge protocol Here is a code block for the command "Engage" .Ed .Pp درون یک بلوک کد، متن متناسب با قالب خروجی گریز داده می‌شود. بنابراین، نویسه‌هایی که در زبان‌های دیگر پردازش متن معمولاً باید گریز داده شوند، مانند علامت اند .Pq Dq & نیازی به گریز دادن ندارند. .Bd -literal -offset indent Here is how you start the program xterm: xterm & .Ed .Pp متناوباً، بلوک‌های کد در صورتی که با سه یا تعداد بیشتری بک‌تیک یا تیلدا احاطه شده باشند، .Dq حصاردار (fenced) نامیده می‌شوند. حصار کد می‌تواند اختیاری شامل نام زبان مورد استفاده پس از سرآیند باشد، مانند نمونه زیر: .Bd -literal -offset indent ```c int main(void) { puts("Engage!"); return 0; } ``` .Ed .Pp زبان مشخص‌شده، در صورت ارائه، معمولاً به عنوان اطلاعات کمکی نظیر کلاس HTML به خروجی منتقل می‌شود. . .Ss "خطوط افقی (Horizontal Rules)" خط افقی خطی است که در سرتاسر یک صفحه خروجی کشیده می‌شود. این خطوط با سه یا تعداد بیشتری ستاره .Pq Dq * , خط تیره .Pq Dq \- , یا خط زیرین .Pq Dq _ در خط جداگانه خود فراخوانی می‌شوند. فاصله‌های میان این نویسه‌ها نادیده گرفته می‌شوند. .Bd -literal -offset indent *** * * * --- - - - ___ _ _ _ ___________________________ .Ed . . .Ss "فراداده (Metadata)" اسناد می‌توانند شامل فراداده‌هایی باشند که بخشی از متن اصلی نیستند. ساختار دستوری از مشخصات MMD و Pandoc پیروی می‌کند. .Pp در ساختار دستوری MMD، بلوک در اولین خط سند آغاز شده و تا نخستین خط خالی ادامه می‌یابد. کلیدها و مقادیر با دونقطه و جفت‌ها با یک خط جدید جدا می‌شوند. یک کلید (و مقدار متعاقب آن) باید در خط آغازین جفت فراداده وجود داشته باشد، اما مقدار می‌تواند در چندین خط امتداد یابد. .Bd -literal -offset indent Title: Captain's log Author: Captain J-L Picard Summary: As part of an exchange program, we're taking aboard a Klingon officer to return the recent visit of Commander Riker to the cruiser Pagh. Stardate: 43917.4 .Ed .Pp متناوباً، یک بلوک از فراداده‌های MMD می‌تواند با خطی از .Qq --- آغاز شده و با .Qq --- یا .Qq \&... پایان یابد. .Pp چنانچه چندین خط متن در مقدار یک فراداده وجود داشته باشد، خطوط بعدی باید (اما الزامی نیست) با فاصله خالی تورفتگی داشته باشند. در غیر این صورت، نباید دونقطه در مقدار وجود داشته باشد، چرا که به عنوان کلید جفت بعدی تعبیر خواهد شد. .Pp انتهای هر خط را با دو فاصله خاتمه دهید تا از رندر شدن شکست‌های خط در خروجی برای رندرکننده‌های غیرمنطبق Markdown اطمینان حاصل شود. علاوه بر این، آغاز یک سند با یک جمله معمولی حاوی دونقطه ممکن است باعث فراخوانی فراداده شود. برای گریز از این موضوع، یک خط خالی به ابتدای سند بیفزایید. .Pp کلیدهای فراداده باید از نویسه‌های الفبایی-عددی ASCII، خط تیره .Pq Qq \&- , یا خط زیرین .Pq Qq \&_ تشکیل شوند. آن‌ها باید حداقل یک نویسه داشته باشند، فاصله‌های خالی آن‌ها حذف می‌شود، نویسه‌های غیرمنطبق با خط زیرین جایگزین می‌گردند، و به حروف کوچک تبدیل می‌شوند. .Pp مقادیر فراداده متنی کدر و غیرقابل تفسیر هستند: عبارت‌های Markdown (مانند حروف کج، موجودیت‌ها و غیره) عیناً کپی می‌شوند. فاصله‌های خالی ابتدایی مقادیر (یعنی فاصله پس از دونقطه) حذف خواهد شد. .Pp اگر چندین کلید فراداده به یک نام یکسان ختم شوند، آخرین فراخوانی حفظ می‌شود. این بررسی پس از استانداردسازی نام با حذف فاصله‌ها، تبدیل به حروف کوچک، و جایگزینی نویسه‌های ناشناخته صورت می‌گیرد. .Pp در ساختار دستوری Pandoc، بلوک در اولین خطی که با علامت درصد یا فاصله شروع نمی‌شود متوقف می‌گردد. فراداده حداکثر به سه کلید محدود است: عنوان (title)، نویسنده یا نویسندگان (author)، و تاریخ (date). خط اول برای عنوان، خط دوم (در صورت ارائه) برای نویسندگان، و خط سوم (در صورت ارائه) برای تاریخ است. خطوط می‌توانند با شروع خط بعدی با یک فاصله ادامه یابند. اگر تنها یک خط با درصد ابتدایی گنجانده شود، فراداده فقط برای عنوان است؛ اگر دو خط باشد، برای عنوان و نویسندگان؛ و به همین ترتیب. اگر یک خط با درصد ابتدایی خالی باشد، فراداده متناظر خالی (نامشخص) باقی می‌ماند. .Bd -literal -offset indent % A Skin of Evil % Tasha Yar Armus % 1988-04-2525 Wow what a day... .Ed .Pp چندین نویسنده می‌توانند با چند فاصله خالی (از جمله خطوط جدید)، یک نقطه-ویرگول، یا هر دو از هم جدا شوند. .Pp خط عنوان Pandoc به طور خودکار بررسی می‌شود که آیا عنوانی به سبک صفحه راهنما (manpage) است یا خیر: .Bd -literal -offset indent % TREK(6) .Ed .Pp ابزار .Nm lowdown عنوان یک صفحه راهنما را از روی پرانتز باز و به دنبال آن یک عدد (یا .Qq n ) , نویسه‌های اختیاری بعدی، و سپس یک پرانتز بسته شناسایی می‌کند. در صورت یافتن، عنوان به دو بخش نام عنوان و بخش (section) تفکیک می‌شود. هر متنی پس از عنوان به عنوان منبع (source) شناسایی شده و چنانچه یک خط عمودی شناسایی شود، متن پس از آن به عنوان جلد (volume) تلقی می‌گردد. .Bd -literal -offset indent % TREK(6) OpenBSD | Games Manual .Ed .Pp به این مقادیر می‌توان با کلیدهای فراداده .Li title و .Li section , و به صورت اختیاری .Li volume و .Li source دسترسی داشت. .Pp با استفاده از هر دو ساختار دستوری، تاریخ‌ها ترجیحاً باید در قالب YYYY-MM-DD باشند، اما می‌توانند در هر قالبی قرار گیرند. مقادیر فراداده را می‌توان با ارجاع به .Li \&[%key] در سند الصاق کرد، مانند استفاده از مثال فوق، باز هم با این نکته که نشانه‌گذاری‌های Markdown (حروف کج و غیره) عیناً کپی می‌شوند: .Bd -literal -offset indent date: 43917.4 It's currently stardate [%date]. .Ed .Pp یا با استفاده از Pandoc: .Bd -literal -offset indent % % % 43917.4 It's currently stardate [%date]. .Ed . . .Ss "ریاضیات (Mathematics)" پشتیبانی از ریاضیات یک افزونه برای Markdown است. این افزونه تنها نحوه آغاز و پایان بلوک‌های ریاضی را توصیف می‌کند: معادلات داخل بلوک معمولاً در فرمت LaTeX هستند و در بخش رابط کاربری (مانند HTML) پیاده‌سازی می‌شوند. دو نوع وجود دارد: درون‌خطی و بلوکی. هر دو می‌توانند در هر نقطه‌ای از جریان متن قرار گیرند. معادلات درون‌خطی به عنوان بخشی از متن رندر می‌شوند؛ معادلات بلوکی به صورت مستقل رندر می‌گردند. .Bd -literal -offset indent This is an inline $f(x)$ function. This is a block $$f(x)$$ function. This is also an inline \e\e(f(x)\e\e) function. This is also a block \e\e[f(x)\e\e] function. .Ed . .Ss "جدول‌ها (Tables)" جدول‌ها یک افزونه GFM (GitHub-flavoured Markdown) برای ساختار دستوری پایه هستند. آن‌ها از یک سرآیند و بدنه جدول تشکیل می‌شوند، و ستون‌ها می‌توانند چپ‌چین، راست‌چین یا وسط‌چین باشند. .Bd -literal -offset indent | Officer | Rank | | --------------: | -------------------- | | Jean-Luc Picard | Captain | | Worf | Lieutenant Commander | | Data | Lieutenant Commander | | William Riker | Commander | .Ed .Pp پس از سرآیند جدول باید یک خط از خط تیره‌ها با حداقل سه خط تیره/دونقطه برای هر ستون قرار گیرد. ستون‌ها با خطوط عمودی جدا می‌شوند. علامت دونقطه نشان‌دهنده تراز است: دونقطه در ابتدا به معنای چپ‌چین، در انتها به معنای راست‌چین، و در هر دو طرف به معنای وسط‌چین است. .Pp جداکننده ستون در ابتدا و انتهای خط اختیاری و زائد است. وجود داده‌های جدول ضروری نیست، اما سرآیند جدول الزامی است. حداقل ساختار جدول برای نمونه بالا عبارت است از: .Bd -literal -offset indent Officer | Rank --:|--- Jean-Luc Picard | Captain .Ed .Pp ستون‌های جدول می‌توانند شامل عناصر درون‌خطی دلخواه باشند. . .Ss "تعریف پاورقی (Footnote Definition)" پاورقی‌ها یک افزونه MMD برای ساختار دستوری پایه هستند. تعاریف پاورقی می‌توانند در هر کجای متن (به جز درون بلوک‌ها) قرار گیرند و توسط یک .Sx "ارجاع پاورقی (Footnote Reference)" به آن‌ها .Dq ارجاع داده می‌شود . آن‌ها شامل نام پاورقی (درون قلاب و مقدم با علامت توان ^)، یک دونقطه، و سپس تمام متن باقی‌مانده در بلوک به عنوان محتوای پاورقی هستند. .Bd -literal -offset indent [^pt]: Klingon insult, meaning something like "weirdo," deriving from the verb "to be weird" (**taQ**), with and [sic] you (plural) imperative prefix (**pe-**). .Ed .Pp محتوای پاورقی می‌تواند در همان خط دونقطه قرار گیرد. نام پاورقی به صورت یک عدد رندر می‌شود. اگر به یک تعریف پاورقی ارجاع داده نشود، چاپ نخواهد شد. . .Ss "بلوک‌های HTML (HTML Blocks)" قراردادن HTML تعبیه‌شده توصیه نمی‌شود، زیرا مانع از قالب‌بندی در خروجی‌های غیر HTML می‌گردد، اما همچنان پذیرفته می‌شود. بلوک‌های HTML باید با یک عنصر شناخته‌شده سطح بلوک HTML آغاز شوند. .Pp در Markdown اولیه، عناصر سطح بلوک به خوبی توسط HTML4 تعریف شده بودند. عناصر HTML5 نیز پذیرفته می‌شوند، اما از آنجا که مفهومی از سطح بلوک در HTML5 وجود ندارد، این موارد غیراستاندارد هستند. عناصر پذیرفته‌شده عبارتند از: .Li
, .Li
, .Li