# Markdown में लिखें

जाने-पहचाने Markdown से ड्राफ़्ट तैयार करें और सहयोगियों के लिए PDF या संपादन योग्य डॉक्यूमेंट बनाएँ।

Markdown रिसर्च नोट्स, रिपोर्ट और शुरुआती ड्राफ़्ट के लिए अच्छी तरह काम करता है। Oleafly इसे एक समर्पित फ़ॉर्मैटिंग टूलबार और Pandoc बिल्ड पाथ देता है, साथ में ऐप के बाहर भी इस्तेमाल होने वाली सोर्स फ़ाइलें।

## एक रिपोर्ट बनाएँ

1. **New project → Use a template → Blank Markdown document** चुनें।
2. प्रोजेक्ट का नाम **फ़ील्ड नोट्स** रखें और `main.md` खोलें।
3. यह उदाहरण पेस्ट करें, फिर **Recompile** चुनें या **⌘Enter / Ctrl+Enter** दबाएँ।
4. अगर Oleafly किसी ज़रूरी इंजन का सेटअप करने की पेशकश करे, तो वह सेटअप पूरा करके दोबारा कंपाइल करें।

```markdown title="main.md"
---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.
```

PDF में एक टाइटल, हेडिंग, एक क्रमांकित सूची और एक टेबल होनी चाहिए। पहली `---` लाइनों की जोड़ी के बीच का मेटाडेटा डॉक्यूमेंट का टाइटल और लेखक तय करता है।

## सोर्स और विज़ुअल एडिटिंग

टूलबार के शुरू में मौजूद स्विच के तीन मोड हैं। **Code** Markdown को सीधे संपादित करता है। **Visual** हेडिंग, पैराग्राफ़, सूचियों, लिंक, इमेज और टेबल के लिए फ़ॉर्मैट हुआ संपादन देता है। **Both** सोर्स और फ़ॉर्मैट हुआ टेक्स्ट साथ दिखाता है। **Stacked** या **Split** चुनने के लिए इसका मेन्यू खोलें। नए प्रोजेक्ट Code में खुलते हैं, और हर प्रोजेक्ट उस मोड को याद रखता है जिसमें आपने उसे छोड़ा था।

Underline, Highlight, Superscript और Subscript Code मोड में Pandoc फ़ॉर्मैटिंग कंट्रोल हैं। उनके बटन Visual मोड में छिपे रहते हैं। मेटाडेटा, साइटेशन सिंटैक्स या दूसरे सोर्स कंस्ट्रक्ट के साथ काम करते समय Code इस्तेमाल करें।

[उदाहरण का सोर्स डाउनलोड करें](/examples/writing-example.md)

## हर टूलबार टूल

फ़ॉर्मैटिंग कंट्रोल पर क्लिक करने से पहले टेक्स्ट चुनें। Code मोड में ज़्यादातर टूल सेलेक्शन को रैप करते हैं या प्लेसहोल्डर जोड़ते हैं। बार में समा न सकने वाले कंट्रोल तक पहुँचने के लिए **More formatting options** (`…`) खोलें।

### Code / Visual

**Code**, **Visual** और **Both** के बीच बदलें। हर मोड में डॉक्यूमेंट Markdown सोर्स ही रहता है।

### Undo

अंतिम बदलाव पूर्ववत करें। ⌘Z / Ctrl+Z।

### Redo

पूर्ववत किया बदलाव वापस लाएँ। **⌘Shift+Z / Ctrl+Shift+Z**।

### Heading → Title

हेडिंग मेन्यू से **Title** चुनकर `# Title` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Heading → Section

हेडिंग मेन्यू से **Section** चुनकर `## Section` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Heading → Subsection

हेडिंग मेन्यू से **Subsection** चुनकर `### Subsection` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Heading → Subsubsection

हेडिंग मेन्यू से **Subsubsection** चुनकर `#### Subsubsection` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Heading → Minor heading

हेडिंग मेन्यू से **Minor heading** चुनकर `##### Minor heading` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Heading → Paragraph heading

हेडिंग मेन्यू से **Paragraph heading** चुनकर `###### Paragraph heading` जोड़ें। हेडिंग टेक्स्ट को अपने टाइटल से बदलें।

### Bulleted list

अक्रमित सूची शुरू करें। `- Item`।

### Numbered list

एक क्रम शुरू करें। `1. Item`।

### Task list

Code मोड में एक टास्क जोड़ें और पूरा होने पर `[ ]` को `[x]` कर दें। `- [ ] Task`।

### Blockquote

किसी उद्धरण को उसकी अपनी लाइन पर रखें। `> quoted text`।

### Bold

चुने हुए टेक्स्ट पर ज़ोर दें। `**text**`; ⌘B / Ctrl+B।

### Italic

किसी पद पर ज़ोर दें। `*text*`; ⌘I / Ctrl+I।

### Strikethrough

टेक्स्ट को अप्रचलित चिह्नित करें। `~~text~~`।

### Inline code

फ़ाइलनाम, कमांड या आइडेंटिफ़ायर फ़ॉर्मैट करें। बैकटिक में बंद टेक्स्ट।

### Underline

Code मोड में कोई वाक्यांश चुनें। `[text]{.underline}`।

### Highlight

Code मोड में कोई वाक्यांश चुनें। `[text]{.mark}`।

### Superscript

Code मोड में घातांक चुनें। `^text^`।

### Subscript

Code मोड में अधोलेख चुनें। `~text~`।

Underline और Highlight Pandoc एट्रिब्यूट इस्तेमाल करते हैं ताकि फ़ॉर्मैटिंग PDF तक पहुँच सके। पांडुलिपि में raw HTML टैग जोड़ने की जगह इन कंट्रोल का इस्तेमाल करें।

### Insert link

**Code** मोड में: `[link text](url)` जोड़ता है। दोनों प्लेसहोल्डर बदलें।

**Visual** मोड में: **Link URL** खोलता है। पता डालें और उसे अपने सेलेक्शन पर लागू करें। लिंक हटाकर सिर्फ़ टेक्स्ट रखने के लिए **Remove link** इस्तेमाल करें।

### Insert image

**Code** मोड में: `![caption](image-filename)` जोड़ता है। पाथ और कैप्शन बदलें।

**Visual** मोड में: **Image file** खोलता है। `figures/plot.png` जैसा कोई प्रोजेक्ट पाथ डालें और लागू करें।

### Insert table

**Code** मोड में: तीन कॉलम, एक हेडर और दो डेटा पंक्तियाँ जोड़ता है। कॉलम के नाम और सेल बदलें।

**Visual** मोड में: वही शुरुआती आकार लेकर संपादन योग्य टेबल जोड़ता है।

### Draw a diagram

[डायग्राम कंपोज़र](/docs/figures-diagrams/) को Mermaid मोड में खोलता है। कैनवास पर फ़्लोचार्ट बनाएँ या Mermaid कोड संपादित करें, फिर उसे कर्सर पर फ़ेंस्ड `mermaid` कोड ब्लॉक के रूप में जोड़ने के लिए **Insert as Mermaid** चुनें। [Mermaid डायग्राम](#mermaid-diagrams) देखें।

### Document insights

डॉक्यूमेंट की हेडिंग, फ़िगर, टेबल, समीकरण, लेबल, साइटेशन और TODO सोर्स क्रम में सूचीबद्ध करता है, हर एक उसकी लाइन से जुड़ा हुआ। यह फ़्रंट मैटर से टाइटल, लेखक, कीवर्ड, तारीख़ और एब्स्ट्रैक्ट भी पढ़ता है और सबमिशन फ़ॉर्म के लिए उन्हें कॉपी कर सकता है। [डॉक्यूमेंट इनसाइट्स](/docs/document-insights/) देखें।

### Document settings

डॉक्यूमेंट क्लास, पेज का आकार, कॉलम, मार्जिन, बॉडी फ़ॉन्ट, फ़ॉन्ट का आकार, भाषा, लाइन स्पेसिंग और सेक्शन नंबरिंग बदलता है। Oleafly आपकी पसंद उस YAML फ़्रंट मैटर में लिखता है जिसे Pandoc पढ़ता है, और फ़ाइल में फ़्रंट मैटर न होने पर उसका ब्लॉक जोड़ देता है। [डॉक्यूमेंट सेटिंग्स](/docs/document-settings/#markdown) देखें।

### Project info

**Code** मोड में: प्रोजेक्ट के आँकड़े और सेलेक्शन की जानकारी दिखाता है।

**Visual** मोड में: विज़ुअल एडिटिंग सतह के आँकड़े दिखाता है।

### Find

**Code** मोड में: ⌘F / Ctrl+F के साथ सक्रिय फ़ाइल की खोज खोलता है।

**Visual** मोड में: सोर्स टूलबार का Find बटन छिपा रहता है।

किसी इमेज को संदर्भित करने से पहले उसे फ़ाइल ट्री से इंपोर्ट करें। इमेज पाथ को पांडुलिपि के सापेक्ष रखें, ताकि सोर्स आर्काइव किसी दूसरे कंप्यूटर पर भी काम करे।

## समीकरण और कोड ब्लॉक

इनलाइन गणित को `$x^2$` की तरह लिखें। डिस्प्ले समीकरण को डॉलर चिह्नों की दो जोड़ियों के बीच रखें:

```markdown
$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$
```

कोड सैंपल के लिए, कोड को तीन बैकटिक में बंद करें और उसकी भाषा को शुरुआती फ़ेंस के बाद लिखें। ये सोर्स कंस्ट्रक्ट हैं; Markdown टूलबार में समीकरण या फ़ेंस्ड कोड ब्लॉक का अलग बटन नहीं है।

## Mermaid डायग्राम

डायग्राम कंपोज़र में Mermaid फ़्लोचार्ट बनाने के लिए टूलबार पर **Draw a diagram** चुनें। **Insert as Mermaid** उसे फ़ेंस्ड कोड ब्लॉक के रूप में जोड़ता है:

````markdown
```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```
````

**Both** मोड में फ़ॉर्मैट हुआ पक्ष ब्लॉक को डायग्राम के रूप में बनाता है। PDF को इमेज चाहिए, इसलिए कंपोज़र एक रेंडर हुई PNG `figures/mermaid-<hash>.png` पर भी सहेजता है, और कंपाइल उस इमेज को ब्लॉक की जगह रख देता है। इसलिए डायग्राम कंपाइल हुए PDF में भी दिखता है। अगर आप बाद में ब्लॉक को हाथ से संपादित करते हैं, तो आपके दोबारा कंपोज़र से डायग्राम जोड़ने या सहेजने तक PDF कोड दिखाता है। [Markdown डॉक्यूमेंट में Mermaid](/docs/figures-diagrams/#mermaid-in-markdown-documents) देखें।

## उद्धरण और ग्रंथसूची

`references.bib` इंपोर्ट करें या बनाएँ, YAML मेटाडेटा में `bibliography: references.bib` जोड़ें, और किसी मौजूदा की को `[@citation-key]` से उद्धृत करें। Pandoc फ़ॉर्मैट किए उद्धरण और संदर्भ सूची बनाने के लिए ग्रंथसूची का इस्तेमाल करता है।

[संदर्भ खोजें और प्रबंधित करें →](/docs/citations/)

## इंपोर्ट और एक्सपोर्ट

किसी मौजूदा ड्राफ़्ट को Markdown में रखने के लिए, Blank Markdown document बनाएँ, ड्राफ़्ट को `main.md` में पेस्ट करें, और उसकी इमेज व ग्रंथसूची इंपोर्ट करें। लाइब्रेरी का अलग **Markdown document** इंपोर्ट फ़िलहाल ड्राफ़्ट को LaTeX में बदल देता है। [इंपोर्ट रास्ते](/docs/import-project/) दोनों रास्ते समझाते हैं।

PDF के लिए कंपाइल करें, या Word, HTML, Typst, LaTeX या प्लेन टेक्स्ट बनाने के लिए **Export** इस्तेमाल करें। मूल Markdown और उसके एसेट साझा करने के लिए सोर्स ZIP इस्तेमाल करें। [अपना काम एक्सपोर्ट करें](/docs/export/) इस क्रम और बदली हुई फ़ाइल में करने योग्य जाँचों को समझाता है।