דלג לתוכן הראשי
mdreadermarkdownכלי-פיתוחAI

בניתי כלי להצגה נוחה של MD — כי ה-AI שלי לא מפסיק לכתוב

16 באפריל 20264 דק׳ קריאה

הבעיה: מבול של MarkDown (MD)

אם אתם עובדים עם Claude Code (ה-CLI של Anthropic), אתם יודעים שהחיים שלכם הם MD. יש CLAUDE.md שמגדיר את ההקשר של הפרויקט. יש קבצי זיכרון ב-.claude/ שהכלי כותב ומעדכן. יש מפרטים שנכתבים בעברית ומתורגמים לאנגלית. יש changelogs, פרומפטים שמורים ותיעוד שנוצר אוטומטית.

וזה לא רק Claude. כל כלי ה-GenAI עובדים ככה — ChatGPT, Gemini, Copilot — כולם "מדברים" ב-MD. זה פורמט התקשורת של עידן ה-AI. ולאחרונה גם MDX הפך לסטנדרט בתיעוד מודרני.

הבעיה היא שקבצי MD גולמיים נראים נורא לעין. כותרות עם ###, קישורים בסוגריים מרובעים, בלוקים של קוד עטופים ב-backticks. לפעמים צריך פשוט כלי להצגה נוחה של קובץ ה-MD מרונדר (rendered) — בדיוק כמו שהוא נראה ב-GitHub — בלי לדחוף אותו באמת ל-GitHub.

בנוסף, עבור מי שעובד הרבה בעברית (מתרגם מסמכים, כותב מפרטים ומשווה בין גרסאות עברית לאנגלית), רוב הכלים פשוט לא תומכים ב-RTL בצורה נוחה.

מה ניסיתי (ולמה זה לא עבד)

  • VS Code Preview — עובד, אבל מחייב פתיחה של VS Code ולא מאפשר השוואה נוחה של שני קבצי MD מרונדרים.
  • Obsidian — כלי מעולה, אבל המטרה שלו היא אחרת (ניהול ידע והערות), הוא דורש התקנה, ולכן הוא לא ממש מתאים למשימה של מציג קבצים מהיר.
  • Typora — כלי טוב, אבל דורש התקנה. רציתי משהו שאפשר פשוט לפתוח ברגע.
  • grip — דורש Python, הקמת שרת, ו-API token של GitHub. קצת מוגזם למשימה פשוטה.
  • כלים אונליין — דורשים העלאת קובץ ה-MD לענן, וזה ממש לא מתאים לקבצים פנימיים או רגישים.

רציתי פתרון פשוט: קובץ אחד, בלי התקנה, בלי שרת ובלי אינטרנט. כלי שנפתח בדאבל-קליק, גוררים לתוכו MD ורואים תוצאה יפהפייה ונוחה לקריאה. עם תמיכה מלאה ב-RTL ואפשרות השוואה צד-בצד.

אז בניתי אחד

האירוניה היא שבניתי את זה עם Claude Code עצמו. הכלי שיוצר את ההרים של MD, עזר לי לבנות כלי שמציג אותם. קראתי לו MD/MDX Viewer.

מה בפנים?

  • קובץ HTML בודד — שוקל רק כ-188KB. הכל inline (כולל marked.js, highlight.js ו-CSS). אפס תלויות חיצוניות.
  • פאנל כפול להשוואה — גוררים קובץ לצד שמאל, קובץ אחר לימין. מושלם לתרגומים, גרסאות לפני/אחרי או השוואת מפרטים.
  • RTL/LTR לכל פאנל בנפרד — כפתור החלפת כיוון טקסט לכל צד, חובה למי שעובד במקביל באנגלית ובעברית.
  • סנכרון גלילה — כשגוללים פאנל אחד, השני זז איתו. קריטי להשוואת מסמכים.
  • תכונות נוספות — הדגשת קוד (syntax highlighting), ספירת מילים, Dark/Light mode כמובן, וממשק Drag & Drop נקי שפשוט זורקים אליו קבצי MD.

מה אין בפנים?

שרת, npm install, Electron, חשבון משתמש, ענן או טלמטריה. הכל רץ מקומית לחלוטין דרך file:// בדפדפן. Chrome, Edge, Firefox — פשוט פותחים את קובץ ה-MD וזהו.

איך מתחילים?

הכלי נבנה להיות סופר אינטואיטיבי ומוכן לעבודה מיד:

  1. להריץ ישירות מ-GitHub Pages — בלי להוריד כלום, פשוט נכנסים לקישור, גוררים קובץ למסך ומתחילים לעבוד.
  2. להוריד כקובץ מקומי (index.html) — מורידים את הקובץ ופותחים בדאבל-קליק לעבודה אופליין לחלוטין.

למרות שהממשק ברור מאוד ומסביר את עצמו, למי שרוצה להכיר לעומק את כל הפיצ'רים, הכנתי מדריך למשתמש מלא.

📝
MD/MDX Viewer
מציג קבצי MD ו-MDX בדאבל-קליק. כולל תצוגת השוואה צד-בצד, תמיכה מלאה ב-RTL ומצב כהה – הכל רץ מקובץ HTML בודד, ללא צורך בהתקנה.

תגובות