[syntax] मार्कडाउन में टिप्पणियाँ



6 Answers

मैं मानक एचटीएमएल टैग का उपयोग करता हूं, जैसे

<!---
your comment goes here
and here
-->

ट्रिपल डैश नोट करें। लाभ यह है कि यह टीएक्स या एचटीएमएल आउटपुट उत्पन्न करते समय pandoc साथ काम करता है। अधिक जानकारी pandoc-discuss समूह पर उपलब्ध है।

Question

एक मार्कडाउन फ़ाइल में टिप्पणी संग्रहीत करने के लिए वाक्यविन्यास क्या है, उदाहरण के लिए फ़ाइल के शीर्ष पर एक सीवीएस $ आईडी $ टिप्पणी? मुझे मार्कडाउन प्रोजेक्ट पर कुछ भी नहीं मिला।




यह गिटहब पर काम करता है:

[](Comment text goes here)

परिणामी एचटीएमएल इस तरह दिखता है:

<a href="Comment%20text%20goes%20here"></a>

जो मूल रूप से एक खाली लिंक है। जाहिर है आप इसे प्रस्तुत पाठ के स्रोत में पढ़ सकते हैं, लेकिन आप इसे गिटहब पर भी कर सकते हैं।




<!--- ... --> 

पांडोक मार्कडाउन (पांडोक 1.12.2.1) में काम नहीं करता है। टिप्पणियां अभी भी एचटीएमएल में दिखाई दीं। निम्नलिखित काम किया:

Blank line
[^Comment]:  Text that will not appear in html source
Blank line

फिर + फुटनोट एक्सटेंशन का उपयोग करें। यह अनिवार्य रूप से एक फुटनोट है जिसे कभी संदर्भित नहीं किया जाता है।




तुम कोशिश कर सकते हो

[](
Your comments go here however you cannot leave
// a blank line so fill blank lines with
//
Something
)



kramdown रुबी-आधारित kramdown इंजन जो kramdown लिए डिफ़ॉल्ट है और इस प्रकार kramdown ने अपने विस्तार वाक्यविन्यास के माध्यम से अंतर्निहित टिप्पणी का समर्थन किया है :

{::comment}
This text is completely ignored by kramdown - a comment in the text.
{:/comment}

Do you see {::comment}this text{:/comment}?
{::comment}some other comment{:/}

इन-लाइन टिप्पणियों की अनुमति देने का लाभ है, लेकिन अन्य मार्कडाउन इंजनों के लिए पोर्टेबल नहीं होने का नकारात्मक पक्ष है।




गैर-eval, गैर-गूंज आर ब्लॉक में टिप्पणियां डालने के बारे में कैसे? अर्थात,

```{r echo=FALSE, eval=FALSE}
All the comments!
```

मेरे लिए अच्छा काम करने लगता है।




यदि आप जैकिल या ऑक्टोप्रेस का उपयोग कर रहे हैं तो भी काम करेगा।

{% comment %} 
    These commments will not include inside the source.
{% endcomment %}

लिक्विड टैग {% comment %} को पहले पार्स किया गया है और मार्कडाउन प्रोसेसर से पहले भी हटा दिया गया है। आगंतुक तब नहीं देख पाएंगे जब वे अपने ब्राउज़र से स्रोत देखने का प्रयास करेंगे।




Related