دليل Frontmatter في Markdown

Frontmatter هو قسم اختياري من البيانات التعريفية في أعلى ملفات Markdown، يُستخدم عادة بواسطة مولدات المواقع الثابتة وأنظمة إدارة المحتوى.

الصيغة الأساسية

---
title: عنوان المستند
date: 2024-01-15
author: أحمد
tags: [markdown, frontmatter, دليل]
published: true
---

# محتوى المستند

بقية محتوى Markdown الخاص بك...

صيغ Frontmatter

YAML (الأكثر شيوعاً)

---
title: دليلي
description: وصف مفصل للمستند
categories:
  - برمجة
  - تطوير الويب
author:
  name: أحمد محمد
  email: ahmad@example.com
---

JSON

{
  "title": "دليلي",
  "date": "2024-01-15",
  "tags": ["markdown", "json"]
}

TOML

+++
title = "دليلي"
date = 2024-01-15
tags = ["markdown", "toml"]
+++

أنواع البيانات

---
# نص
title: "عنوان المستند"

# رقم
views: 1234
rating: 4.5

# منطقية
published: true
featured: false

# قوائم
tags: [markdown, yaml, frontmatter]
categories:
  - برمجة
  - تعليم

# كائنات
author:
  name: أحمد
  bio: مطور ويب
  
# تواريخ
created: 2024-01-15
updated: 2024-01-20T15:30:00Z

# null
deprecated: null
---

حالات الاستخدام الشائعة

منشورات المدونة

---
title: تعلم Markdown في 10 دقائق
slug: learn-markdown-10-minutes
date: 2024-01-15
author: أحمد محمد
excerpt: دليل سريع لتعلم أساسيات Markdown
featured_image: /images/markdown-guide.jpg
tags: [markdown, تعليم, دليل]
category: برمجة
published: true
---

توثيق

---
title: دليل API
version: 2.0
api_endpoint: https://api.example.com/v2
last_updated: 2024-01-15
sidebar_position: 3
---

الخلاصة

Frontmatter هو طريقة قوية لإضافة بيانات هيكلية إلى مستندات Markdown الخاصة بك. استخدمه لتحسين تنظيم المحتوى، SEO، وقدرات المعالجة الآلية.

موارد إضافية

• مواصفات YAML
• دليل Jekyll Frontmatter
• دليل Hugo Frontmatter