# Markdown في الطرفية

افتح ملف `.md` أو `.markdown` باستخدام Elide لقراءته مستندًا منسّقًا في الطرفية.
استخدمه لملف README في مستودع، أو دليل تشغيل عبر SSH، أو ملاحظات التطوير دون مغادرة الصدفة. لا يلزم وجود مشروع Elide.

## قراءة ملف README أو دليل تشغيل

```shell
elide README.md
elide docs/runbook.md
elide run notes.markdown
```

تُنشئ العناوين تسلسلًا هرميًا مرئيًا؛ وتسهّل القوائم والاقتباسات والجداول ولوحات الشيفرة تصفّح المستندات الطويلة.
يلتف النص على عرض الطرفية، وتحظى كتل الشيفرة المسوّرة بتلوين الصياغة للغات المعروفة. تُعرض كتل الشيفرة ولا تُنفَّذ.

تُدعم صياغة CommonMark إلى جانب الجداول والشطب وقوائم المهام بأسلوب GitHub. على سبيل المثال، احفظ هذا باسم
`runbook.md`:

````markdown
# Check the service

- [x] Generate configuration
- [ ] Verify the health endpoint

```shell
curl http://localhost:8080/health
```

| Response | Next step |
| --- | --- |
| 200 | Continue deployment |
| 503 | Check application logs |
````

ثم شغّل `elide runbook.md`. تحتفظ الروابط بوجهاتها، ويُعرض HTML الخام نصًا.

## تصفّح مستند طويل

يطبع Elide المستند المعروض إلى stdout. مرّره عبر أنبوب إلى أداة تصفّح مثل `less` عندما تريد التمرير:

```shell
elide docs/runbook.md | less
```

المخرجات الممرّرة عبر أنبوب عادية افتراضيًا. للإبقاء على ألوان الطرفية مع أداة تصفّح تفهم تسلسلات ⁦ANSI:⁩

```shell
elide --color docs/runbook.md | less -R
```

تتقدّم `--no-color` ومتغير البيئة `NO_COLOR` على اللون المفروض. إذا كان `NO_COLOR` مضبوطًا، فأزله من البيئة قبل
استخدام المثال الملوّن.

## حفظ نسخة نصية مقروءة

عطّل الألوان صراحةً عند حفظ الملاحظات المعروضة في سجل أو مُخرَج:

```shell
elide --no-color notes.markdown > notes.txt
```

يكتب هذا عرض الطرفية بما فيه تخطيطه، بدلًا من تحويل Markdown إلى صيغة مستند أخرى. ويبقى الملف المصدري دون تغيير.
ويحافظ `--quiet` أيضًا على المخرجات المعروضة.

الخيار `--format` مخصص [لمخرجات Pkl و PCF](/docs/pkl-configuration) ويُرفض مع ملفات Markdown. كما يرفض عرض المستندات
`--sandbox` و `--limit`. راجع [مرجع CLI](/docs/cli-references) لخيارات الأمر.