ما د دې وخت کې د دې وړتیاوو په څیر یو څه نه شتون نلري. په هرصورت، HotDog یو حیرانتیا ځانګړتیا لري: د toolbar ټول HTML ټکونه لري (د هغه وخت کې ډیر نه شتون لري) د بوتلونو په توګه، او تاسو کولی شئ د دوی کلیک کولو او د پايلې وګورئ. یوازې ناڅاپي دا دی چې تاسو باید د بوتل بندولو لپاره یو بل بوتل کلیک وکړئ. دا د لومړي WYSIWYG ایډیټر بود، او دا په چټکۍ سره ډیر مشهور شو. خلک چې د HTML په اړه هیڅ پاملرنه نلري، دا کارولو پیل کړ: د ویب سایټونو شمېر په لټه کې و. زه دا یو ځل کارول او د تولید شوي HTML په لټه کې و. د HTML "د لاس" لیکلو زده کړې وروسته، زه دا د Dreamweaver لخوا تولید شوي په روښانه توګه کلمې لرم. زه د خپل HTML په لټه کې یا د IDEs په مرسته کې و. په چټکۍ سره د پینټو کلونو کې. HTML د ویب سایټونو څخه ډیر دی چې په هر ځای کې یو فورمټ وي چې Sir Berners-Lee به فکر نلري چې دا به وي. سره د ویب براؤزرونو سره په ګډه، دا د ویب غوښتنلیکونو لپاره منځني شي. په هرصورت، دا دلته نه بند. حتی په دې وخت کې، زه حیران شو چې JavaDocs HTML تولید کړي. د HTML جوړول. د HTML جوړول. د HTML جوړول. د پیټون Docstring رڼا RDOC د رخصتۍ که تاسو کولی شئ HTML snippets جوړ کړئ، ، په JavaDocs کې، په لړۍ کې د HTML لیکلو په اسانۍ سره د بریښنا په ډیری سرعت کې وده ورکړي. دا آسانه ده چې په بندۍ ټګ کې د slash له لاسه ورکړي، یا د بریښنا ترلاسه کړئ. په لومړي هڅه کې، په ځانګړي ډول که دا شامل دي. په هرصورت، ډیری سندونو ته د HTML بشپړ قدرت ته اړتیا نلري، په ځانګړي ډول د دې نور مدرن نسخهونو لخوا لرو. د ج. <table> د دې ستونزو د حل لپاره، جون Gruber او Aaron Swartz د Markdown په 2004 کال کې اختراع کړ. 
 
 
 د Markdown یو رڼا مارکپ زبان دی چې د ساده متن اډیوټر په کارولو سره formatted متن جوړوي. John Gruber په 2004 کال کې د Markdown په توګه د آسانه لټون مارکپ زبان جوړ کړ. د Markdown د Markdown یو رڼا مارکپ زبان دی چې د ساده متن اډیوټر په کارولو سره formatted متن جوړوي. John Gruber په 2004 کال کې د Markdown په توګه د آسانه لټون مارکپ زبان جوړ کړ. - د د Markdown د مارکډونین د نړۍ له خوا د طوفان په لټه کې و. زه فکر کوم چې دا د HTML څخه ډیر مشهور دی، لږ تر لږه په ټیکنالوژۍ نړۍ کې. دا د عمرونو لپاره په GitHub کې شتون لري. د جاوا په نسخه 25 کې د JavaDocs کې یوځای شوی. او اوس مهال، LLMs د وارداتو او صادرولو لپاره د مارکډونینټ کاروي! د Markdown محدودیتونه Markdown حیرانتیا دی، مګر دا د قوي محدودیتونه لري. زه زما وروستۍ کتاب سره Markdown، په Doc-as-Code روښانه کې لیکل. د تجربه دا دردناک وه چې زه به دا نه ووايي. دلته د کتاب لیکنې تجربه څخه یو ساده خلاص دی. زه غواړم د کوډ ټریپټونو لپاره زما نقطې ښودل کړي. په هرصورت، زه غواړم چې دوی اعتباري وي: کمپلیټ شوي او آزموینې شوي. زه د پروژې لیکل، د جوړولو ترتیب سره بشپړ کړي. په هرصورت، Markdown د غیرقانوني فایلونو شاملولو اجازه نه کوي. زه باید د اړتياوو نندارتونونو کاپي او پوښل وکړم. بدتر، ځکه چې د کتاب جوړولو ځینې وخت ته اړتيا لري، زه د تقاضاونو نسخه تازه ونیسئ. هر وخت چې زه یې کړم، زه باید د تازه شوي کوډ په هر واقعیت کې کاپي-پوښل وکړم. په دلچسپي سره، د پروګرامانو ته اړتیا لرونکي سندونه ورته کارونه لري. یو بل پراخه محدودیت دی چې غواړم چې د یو محصول ته توجه ورکړئ. دلته یو سبک انتخاب دی: Markdown د ورته څه نه وړاندې کوي. له دې امله، د نورو ژبو په اړه څه؟ زه نه پوهیږم؛ زه غواړم چې دا د Markdown برخه وي. د Python Markdown که څه هم ډیری نور دي، زما پایله نقطې به د جدولونو په اړه وي. Markdown د جدولونو په اړه کار کوي، د یوه نقطې پورې، کوم چې د کلینګ نومونه ده. په زما بلاګونه کې، زه په منظم ډول اړتیا لري او ، چې د ملاتړ نه دي. خوشحاله، HTML د Markdown په اعتبار کې دی. په هرصورت، د جدول، کوډ، او داسې نور کې د شکل کولو باید د HTML په ګډه بدل شي. rowspan colspan ASCIDOC Asciidoc د دې محدودیتونو د حل دی. 
 
 
 AsciiDoc د تکنالوژيک موادو د چاپ لپاره یو ساده متن نښه کولو ژبه ده. دا د سیمنټیک عناصر سره بسته دی او د موادو modularize او دوبار استعمال کولو ځانګړتیاوو سره وساتل کیږي. AsciiDoc مواد کولی شي د متن ایډیټر په کارولو سره جوړ شي، په نسخه کنترول سیسټم کې اداره کیږي، او په څو د محصول فارمونو کې چاپ شي. د ASCIDOC AsciiDoc د تکنالوژيک موادو د چاپ لپاره یو ساده متن نښه کولو ژبه ده. دا د سیمنټیک عناصر سره بسته دی او د موادو modularize او دوبار استعمال کولو ځانګړتیاوو سره وساتل کیږي. AsciiDoc مواد کولی شي د متن ایډیټر په کارولو سره جوړ شي، په نسخه کنترول سیسټم کې اداره کیږي، او په څو د محصول فارمونو کې چاپ شي. د ASCIDOC وګورئ چې څنګه د Asciidoc د محدودیتونو په اړه د یو له یو حل کوي: 
 
 
 
 
 
 
 : Include 
 
 An include directive imports content from a separate file or URL into the content of the current document. When the current document is processed, the include directive syntax is replaced by the contents of the include file. Think of the include directive like a file expander. 
 
 
 : Admonitions 
 
 There are certain statements you may want to draw attention to by taking them out of the content’s flow and labeling them with a priority. These are called admonitions. This page introduces you to admonition types AsciiDoc provides, how to add admonitions to your document, and how to enhance them using icons or emoji. 
 
 
 Cell span Asciidoc has a   as well as a  , both managed by the Eclipse Foundation. Note, though, that   is the sole implementation of Asciidoc. The Asciidoctor site is actually hosting the  . For most intents and purposes, you can treat them as one, as I do. specification TCK Asciidoctor Asciidoc documentation د Include دستورالعمل د انفرادي فایل یا URL څخه د اوسني سند په موادو کې مواد واردوي. کله چې د اوسني سند پروسس کیږي، د Include دستورالعمل سټاکس د Include فایل د موادو لخوا بدل کیږي. د Include دستورالعمل په توګه د فایل پراختیا په توګه فکر وکړئ. ډیری بیانونه شتون لري چې تاسو ممکن غواړئ په اړه توجه وکړئ ترڅو دوی د محتویاتو د جریان څخه راټول کړئ او دوی سره د ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو ترټولو زه په اوسط کې لیست کړم چې څنګه Asciidoc درې محدودیتونه حل کوي چې زه په منظم ډول په Markdown کې لرم، مګر دا ډیری ګټې وړاندې کوي. د ځانګړتیاوو ټونونه شتون لري. دلته د دوی څخه ځینې دي، چې زه په منظم ډول کاروئ: 
 
 
 
 
 
 
 
 
 
 : Video embedding A sample is more descriptive than a complete description: [source]
----
video::RX9zwgHuNmA[youtube,width=840,height=473]
----
 
 
 
   , as seen above: Blockquotes with attribution [quote,'https://asciidoc.org/[Asciidoc^]']
____
AsciiDoc is a plain text markup language for writing technical content.
____
 
 
 
 . This one is of utmost importance when I write self-driven workshops: Collapsible blocks [%collapsible]
====
This content is only revealed when the user clicks the block title.
====
 
 
 
 Materializing   is another useful feature for workshops and technical documentation in general: menus and buttons 
 
 
 
 
 Click on the OK button. 
 
 Go to the   item. Text > Text Filters > JSON 
 
 Automatic table of contents د حق toolchain سره، تاسو کولی شئ د Asciidoc څخه HTML جوړ کړئ او د پایلې په GitHub / GitLab Pages کې چاپ کړئ. دلته یو غیر کوچني مثال دی چې څو ځانګړتیاوې ښيي: Apache APISIX Hands-on لابراتوار د Asciidoc اکوسیسټم یو وسایلو یوازې د دې چاپیریال اکوسیسټم په توګه ګټور دی. دلته د دغو وسایلو او ګټې ځینې شتون لري: 
 
 
 
 
 
 
 GitHub renders Asciidoc as well as Markdown. Try using a   and watch the  . Here's a non-exhaustive list of  . README.adoc magic happen Asciidoc integration items with GitHub 
 
 Jekyll, the blog engine, has a seamless  . This blog runs on Jekyll with Asciidoc. Asciidoc integration 
 
 
 
 : Asciidoctor Diagram 
 
 Asciidoctor Diagram is a set of Asciidoctor extensions that enable rendering of plain text diagrams that are embedded in your AsciiDoc document as part of the Asciidoctor conversion process. I use it   with PlantUML. You might have noticed it on this blog already. a lot 
 
 
 : Reveal.js integration Asciidoc allows you to generate regular HTML documents, but Reveal.js enables the creation of slide-based presentations. When I taught at university, I used both regular HTML for seminar works and slides for courses. My old   is available as a GitHub Pages site (in French). Java EE course Icing on the cake, you can leverage the  . diagram integration Asciidoctor Diagram د Asciidoctor پراختیا سیټ دی چې د Asciidoctor بدلولو پروسه په برخه کې ستاسو د AsciiDoc سند کې د ساده متن ډیزاینونه رامینځته کولو ته اجازه ورکوي. د پایلو Markdown په هر ځای کې دی، او زه ډیر خوشحاله ده که دا ستاسو د اړتیاوو پوره کړي. زه څو تجربو ولرئ چې دا زما د انتظارونو پوره نه کوي: تخنیکي سندونه، ورکشاپونه، کورسونه، او د کتاب چاپ. Asciidoc د Markdown لګښتونو بشپړولو لپاره بشپړ وسایلو ده. زه امیدوارم چې دا پست تاسو ته د دې هڅولو لپاره ډیری arguments ورکړي. To go further: 
 
 
 
 
 Asciidoctor سندونه د انټرنیټ ډیزاین REVIEW.js د Asciidoctor ډیزاین Jekyll AsciiDoc پلګن په اصل کې نشر شوي په A Java Geek په 26 اکتوبر، 2025 د جاوا Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

دا غږ د کیسې په اصلي ژبه تولید شوی!

Asciidoc: کله چې Markdown یوازې دا نه پرې کوي

About Author

تبصرې

hang tags

دا مقاله په کې وړاندې شوې وه

Related Stories

Beasts at Bay

Can You Set A Billboard on Fire For Marketing Points?

Teylor has Been Named Startup of the Year 2021 in Zürich

[Writing Prompt] Thrilled to be Recognized as [Insert Award Title Name]

Beasts at Bay

Can You Set A Billboard on Fire For Marketing Points?

Teylor has Been Named Startup of the Year 2021 in Zürich

[Writing Prompt] Thrilled to be Recognized as [Insert Award Title Name]

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps