मैंने खुद को लंबे समय पहले, HotDog (प्रो) नामक एक सॉफ्टवेयर पर HTML सिखाया था. उस समय क्या आप देखते हैं क्या आप प्राप्त कर सकते हैं की तरह कोई चीज नहीं थी. हालांकि, HotDog में एक अद्भुत विशेषता थी: टूलबार में सभी HTML टैग थे (उस समय बहुत से नहीं थे) बटन के रूप में, और आप उन्हें क्लिक करके और परिणामों को देखकर सीख सकते थे. एकमात्र नुकसान यह था कि आपको टैग को बंद करने के लिए एक और बटन पर क्लिक करना पड़ा। फिर Dreamweaver आया. यह पहला WYSIWYG संपादक था, और यह तुरंत बहुत लोकप्रिय हो गया. लोग जो HTML के बारे में कोई जानकारी नहीं थी, इसे उपयोग करना शुरू कर दिया: वेबसाइटों की संख्या बढ़ गई. मैंने इसे एक बार इस्तेमाल किया और उत्पन्न HTML को देखा. हाथ से HTML लिखने के लिए सीखने के बाद, मैंने इसे Dreamweaver द्वारा उत्पन्न किया गया पाया. मैंने हाथ से या आईडीई की मदद से अपना HTML लिखना जारी रखा. तेजी से आगे पंद्रह साल. HTML वेबसाइटों से परे एक सार्वभौमिक प्रारूप होने के लिए चला गया है कि सर बर्नर्स-ली ने नहीं सोचा होगा कि यह बन जाएगा. वेब ब्राउज़रों के साथ मिलकर, यह वेब अनुप्रयोगों के लिए मीडिया बन गया. हालांकि, यह वहां नहीं रुक गया. यहां तक कि उस समय, मुझे आश्चर्य हुआ कि जावाडॉक्स HTML उत्पन्न करता है. HTML बनाएं। HTML बनाएं। HTML बनाएं। Python Docstring के बारे में रूबी आरडीओ आराम से चलना जब आप HTML Snippets लिख सकते हैं, , JavaDocs में, पंक्ति द्वारा HTML लिखना काफी तेजी से एक डोर हो जाता है. यह बंद टैग में एक स्लाश को याद करना आसान है, या एक डोर प्राप्त करना आसान है हालांकि, अधिकांश दस्तावेजों को HTML की पूरी शक्ति की आवश्यकता नहीं है, खासकर इसके अधिक आधुनिक संस्करणों द्वारा लाए गए प्रकार। जी। <table> इस समस्या को हल करने के लिए, जॉन ग्रूबर और एरन स्वार्ट्ज ने 2004 में मार्कडोन का आविष्कार किया। 
 
 
 Markdown एक साधारण पाठ संपादक का उपयोग करके प्रारूपित पाठ बनाने के लिए एक हल्के मार्कअप भाषा है. John Gruber ने 2004 में Markdown को एक आसान पढ़ने के लिए मार्कअप भाषा के रूप में बनाया। मार्कअप Markdown एक साधारण पाठ संपादक का उपयोग करके प्रारूपित पाठ बनाने के लिए एक हल्के मार्कअप भाषा है. John Gruber ने 2004 में Markdown को एक आसान पढ़ने के लिए मार्कअप भाषा के रूप में बनाया। - मार्कअप मुझे लगता है कि यह HTML से भी अधिक लोकप्रिय है, कम से कम तकनीकी दुनिया में. यह उम्र के लिए GitHub पर उपलब्ध रहा है. जावा ने इसे अपने JavaDocs में संस्करण 25 में एकीकृत किया. और आज, एलएलएम इनपुट और आउटपुट के लिए Markdown का उपयोग करते हैं! मार्केटिंग की सीमाएं Markdown अद्भुत है, लेकिन इसमें मजबूत सीमाएं हैं. मैंने अपने नवीनतम पुस्तक को Markdown के साथ लिखा, Doc-as-Code परंपरा में. अनुभव इतना दर्दनाक था कि मैंने कसम खाई कि मैं इसे फिर कभी नहीं करूंगा. यहाँ मेरी किताब लिखने के अनुभव से एक सरल निष्कर्ष है. मैं अपने बिंदुओं को दर्शाने के लिए कोड स्नैप्स को पेश करना चाहता था. हालांकि, मैं चाहता था कि वे वैध हों: संकलित और परीक्षण किया गया. मैंने एक परियोजना लिखी, एक निर्माण कॉन्फ़िगरेशन के साथ पूरा किया। हालांकि, मार्कडाउन बाहरी फ़ाइलों को शामिल करने की अनुमति नहीं देता है. मुझे आवश्यक स्निपेट को कॉपी और पेस्ट करना पड़ा. बदतर, क्योंकि एक पुस्तक लिखने में थोड़ा समय लगता है, मैंने निर्भरताओं के संस्करण को अद्यतन किया। हर बार जब मैंने किया, मुझे हर घटना पर अद्यतन कोड को कॉपी-पेस्ट करना पड़ा. दिलचस्प बात यह है कि डेवलपर्स के लिए निर्देशित दस्तावेज में एक ही उपयोग के मामले हैं. एक और व्यापक सीमा एक वस्तु पर ध्यान आकर्षित करना चाहती है. यहां एक शैली विकल्प है: मार्कडाउन कुछ भी ऐसा नहीं प्रदान करता है. इस कारण से, अन्य भाषाओं के बारे में क्या? मैं नहीं जानता; मुझे उम्मीद है कि यह मार्कडाउन का हिस्सा था। पायथन मार्कडाउन हालांकि कई और हैं, मेरा अंतिम बिंदु तालिकाओं के बारे में होगा. मार्कडाउन तालिकाओं को संभालता है, एक बिंदु तक, जो कॉलम शीर्षक है। और , जो समर्थित नहीं हैं. सौभाग्य से, HTML वैध Markdown है. हालांकि, तालिका के अंदर प्रारूपण, कोड, आदि, इसके साथ ही HTML में परिवर्तित किया जाना चाहिए. rowspan colspan एसिड Asciidoc उपरोक्त सीमाओं का समाधान है। 
 
 
 AsciiDoc तकनीकी सामग्री लिखने के लिए एक साधारण पाठ मार्कअप भाषा है. यह सेमेंटिक तत्वों के साथ पैक किया गया है और सामग्री को मॉड्यूलर करने और पुनः उपयोग करने के लिए सुविधाओं के साथ सुसज्जित है. AsciiDoc सामग्री को एक पाठ संपादक का उपयोग करके संकलित किया जा सकता है, एक संस्करण नियंत्रण प्रणाली में प्रबंधित किया जाता है, और कई आउटपुट प्रारूपों में प्रकाशित किया जा सकता है. एस्सीडॉक AsciiDoc तकनीकी सामग्री लिखने के लिए एक साधारण पाठ मार्कअप भाषा है. यह सेमेंटिक तत्वों के साथ पैक किया गया है और सामग्री को मॉड्यूलर करने और पुनः उपयोग करने के लिए सुविधाओं के साथ सुसज्जित है. AsciiDoc सामग्री को एक पाठ संपादक का उपयोग करके संकलित किया जा सकता है, एक संस्करण नियंत्रण प्रणाली में प्रबंधित किया जाता है, और कई आउटपुट प्रारूपों में प्रकाशित किया जा सकता है. एस्सीडॉक आइए देखें कि 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 फ़ाइल की सामग्री द्वारा प्रतिस्थापित किया जाता है. Think of the include directive like a file expander. कुछ बयान हैं जिन पर आप ध्यान आकर्षित करना चाहते हैं, उन्हें सामग्री के प्रवाह से निकालकर और उन्हें प्राथमिकता के साथ लेबल करते हुए. इनको चेतावनी कहा जाता है. यह पृष्ठ आपको चेतावनी प्रकारों के बारे में पेश करता है AsciiDoc प्रदान करता है, अपने दस्तावेज़ में चेतावनी कैसे जोड़ें, और उन्हें आइकन या इमोजी का उपयोग करके कैसे बढ़ाएं. मैंने ऊपर सूचीबद्ध किया है कि 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 सही टूलचेन के साथ, आप 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 डायग्राम Asciidoctor विस्तारों का एक सेट है जो Asciidoctor रूपांतरण प्रक्रिया के हिस्से के रूप में आपके AsciiDoc दस्तावेज़ में एम्बेड किए गए सरल पाठ डायग्राम का प्रदर्शन करने की अनुमति देता है। निष्कर्ष Markdown हर जगह है, और मैं खुश हूं अगर यह आपकी जरूरतों को पूरा करता है. मेरे पास कई अनुभव थे जहां यह मेरी अपेक्षाओं को पूरा नहीं करता था: तकनीकी दस्तावेज, कार्यशालाएं, पाठ्यक्रम और पुस्तक लिखना। मुझे उम्मीद है कि यह पोस्ट आपको कोशिश करने के लिए पर्याप्त तर्क देता है। To go further: 
 
 
 
 
 Asciidoctor दस्तावेज Asciidoctor reveal.js के बारे में जानें एस्सीडॉक्टर डायग्राम Jekyll AsciiDoc प्लगइन मूल रूप से प्रकाशित A Java Geek पर 26 अक्टूबर, 2025 जावा Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

यह ऑडियो कहानी की मूल भाषा में निर्मित है!

Asciidoc: जब Markdown बस इसे कट नहीं करता है

About Author

टिप्पणियाँ

लेबल

इस लेख में चित्रित किया गया था

Related Stories

AI की शक्ति को उन्मुक्त करना। अत्याधुनिक तकनीकों की एक व्यवस्थित समीक्षा: सार और परिचय

क्लाउड सॉनेट 3.5 सिस्टम प्रॉम्प्ट लीक: एक फोरेंसिक विश्लेषण

हैकरनून कोडेड: शीर्ष 10 देश जहां हैकरनून सबसे अधिक सक्रिय है

उपयोगकर्ता-केंद्रित क्रिप्टो उत्पाद बनाना: ग्राहक प्रतिक्रिया का महत्व

AI की शक्ति को उन्मुक्त करना। अत्याधुनिक तकनीकों की एक व्यवस्थित समीक्षा: सार और परिचय

क्लाउड सॉनेट 3.5 सिस्टम प्रॉम्प्ट लीक: एक फोरेंसिक विश्लेषण

हैकरनून कोडेड: शीर्ष 10 देश जहां हैकरनून सबसे अधिक सक्रिय है

उपयोगकर्ता-केंद्रित क्रिप्टो उत्पाद बनाना: ग्राहक प्रतिक्रिया का महत्व

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps