MarkFlow
العودة للمدونة
Blog Article2025-01-02

لماذا قمت ببناء MarkFlow: يوميات مطور

فر
فريق MarkFlow
5 min read

عملية تحويل Markdown إلى Word آمنة ومحلية

ما زلت أتذكر تلك الليلة من يوم الثلاثاء. كانت الساعة 11 مساءً، وكنت قد انتهيت للتو من التوثيق الفني لواجهة برمجة التطبيقات (API) الجديدة الخاصة بنا.

كان المحتوى جميلاً — مكتوباً بـ Markdown، بهيكل نظيف، وكتل برمجية مثالية، ومخططات Mermaid صالحة تشرح تدفق البيانات. شعرت بذلك الرضا الذي يعرفه كل مطور عندما يتم صقل ملف README.md إلى الكمال.

ثم، ظهر إشعار Slack من مدير مشروعي:

"مرحباً، عمل رائع في التوثيق. هل يمكنك إرسال هذا لي كمستند Word؟ يحتاج الفريق القانوني إلى مراجعته مع تشغيل 'تتبع التغييرات'، وهم لا يستخدمون Markdown."

تنهدت. "بالتأكيد، اعطني خمس دقائق."

الكلمات الأخيرة الشهيرة.

كابوس "الخمس دقائق"

فتحت الطرفية (terminal) وقمت بتشغيل أمر Pandoc سريع. pandoc docs.md -o docs.docx

فتحت النتيجة في Word. وانقبض قلبي.

  • الجداول كانت مكسورة. الأعمدة كانت مضغوطة، والعناوين غير محاذاة.
  • المخططات اختفت. كانت مخططات Mermaid الجميلة مجرد كتل برمجية عارية.
  • تلوين الصيغة قد اختفى. بدا كود Python كنص عادي، صعب القراءة.

فكرت: "حسناً، سأجرب محولاً عبر الإنترنت."

بحثت في جوجل عن "Markdown to Word converter" ونقرت على النتيجة الأولى. طلب مني رفع ملفي. توقفت. كان هذا المستند يحتوي على نقاط نهاية API داخلية ومنطق خاص. لم تكن هناك طريقة لأقوم برفع هذا إلى خادم عشوائي دون سياسة خصوصية واضحة.

لذا، فعلت ما سيفعله أي مطور يائس. فتحت Word على شاشة، و VS Code على الأخرى، وبدأت في النسخ واللصق.

قضيت الساعتين التاليتين في وضع مسافات بادئة للقوائم يدوياً، والتقاط لقطات شاشة لمخططاتي للصقها كصور، وإعادة تطبيق أنماط الخط العريض. بحلول الساعة 1 صباحاً، كنت منهكاً ومحبطاً. لم أكن أكتب كوداً؛ كنت أقاوم معالج نصوص.

الإدراك

في تلك الليلة، أدركت شيئين:

  1. Markdown رائع للكتابة، لكن العالم يعمل على Word. لا يمكننا الهروب منه.
  2. الأدوات الحالية تجبرك على الاختيار: إما قضاء ساعات في تكوين أدوات سطر الأوامر (CLI) مثل Pandoc، أو التضحية بخصوصيتك لمحولات السحابة.

لم أكن أريد أياً منهما. أردت أداة تحترم خصوصيتي (معالجة محلية) و تحترم تنسيقي (دعم GFM).

لذا، قمت ببناء MarkFlow.

بناؤه لنفسي (ولك)

بدأت في بناء MarkFlow كأداة مساعدة صغيرة لاستخدامي الخاص. كان الهدف بسيطاً:

  • يجب أن يكون محلياً. أريد تحويل العقود الحساسة أو التوثيق الشامل دون أن تغادر البيانات متصفحي أبداً.
  • يجب أن يتعامل مع الأشياء "الصعبة". الجداول، وقوائم المهام، ونعم، تلوين الصيغة للكتل البرمجية.
  • يجب أن يكون سريعاً. سحب، إفلات، تم.

عندما عرضت النسخة الأولى لزميلتي، أضاءت عيناها. "انتظر، إنه يحافظ على تنسيق الجدول؟ ولا أحتاج إلى تثبيت Python؟"

حينها عرفت أن هذا لا ينبغي أن يظل مجرد برنامج نصي على جهاز الكمبيوتر المحمول الخاص بي.

لماذا "المحلي أولاً" يهم بالنسبة لي

في عام 2026، خصوصية البيانات ليست رفاهية؛ إنها متطلب. قمت ببناء MarkFlow ببنية فريدة حيث يعمل محرك التحويل مباشرة داخل متصفح الويب الخاص بك.

عندما تستخدم MarkFlow، أنت لا ترسل ملفك إلي. أنت تستخدم جوهرياً تطبيقاً قوياً يصادف أنه يعيش على موقع ويب. هذا يعني أنه يمكنك تحويل اتفاقيات عدم الإفصاح (NDA)، ومسودات براءات الاختراع، والمذكرات الخاصة دون أي خوف من تسرب البيانات.

من إحباطي إلى إنتاجيتك

اليوم، نما MarkFlow من ذلك الإحباط الليلي إلى أداة قوية يثق بها آلاف المستخدمين.

  • لا مزيد من الجداول المكسورة.
  • لا مزيد من ألوان الكود المفقودة.
  • لا مزيد من القلق بشأن الخصوصية.

لقد بنيت هذا حتى لا تضطر أبداً لقضاء ليلة الثلاثاء في محاربة تنسيق Word. ركز على المحتوى؛ ودع MarkFlow يتولى العرض.

جربه مع أحدث ملف .md لديك. آمل أن يوفر لك تلك الساعتين التي لن أستعيدها أبداً.

مطور MarkFlow

#Markdown#إنتاجية#Word#خصوصية#قصة مطور

هل وجدت هذه الأداة مفيدة؟ ساعدنا في نشر الكلمة.

لماذا قمت ببناء MarkFlow: يوميات مطور