איך לכתוב קובץ Markdown שאפשר לייבא אל JW Library
כתבו הערה בפנקס הרשימות, ב-TextEdit או ב-Obsidian, וגרמו לה לנחות על הפסוק הנכון ב-JW Library. בדיוק אילו שורות להקליד, ומה אפשר להשמיט.
JW Sync יודע לקרוא קובצי Markdown אל תוך גיבוי של JW Library, וזה מעלה את השאלה היחידה שבאמת חשובה ברגע שיודעים שהאפשרות קיימת: איך הקובץ אמור להיראות? העמוד הזה עונה מצד הכותב — לא מה הייבוא מוכן לקבל, אלא מה אתם באמת מקלידים.
בקצרה, הערה היא קובץ טקסט. צרו קובץ, כתבו את ההערה, שמרו אותו כשהוא מסתיים ב-.md, והוא ייובא. כל השאר כאן עוסק בשורה אחת שאינה חובה: זו שאומרת לאיזה פסוק ההערה שייכת, כדי שתופיע ב-JW Library בזמן שאתם קוראים את אותו פסוק במקום להישאר מנותקת בין שאר ההערות שלכם.
שום דבר מזה אינו דורש עורך Markdown, ושום דבר אינו דורש שתלמדו Markdown. פנקס הרשימות ב-Windows ו-TextEdit ב-Mac מספיקים. אם אתם כבר מנהלים את הערות הלימוד שלכם ב-Obsidian או ב-Notion, הקבצים האלה הם Markdown ממילא, ולכל אחד מהם יש חלק משלו למטה.
שלב אחר שלב
פתחו כל עורך טקסט פשוט
פנקס הרשימות ב-Windows, TextEdit ב-Mac, או אפליקציית ה-Markdown שאתם כבר משתמשים בה — Obsidian, Typora, iA Writer, Joplin. הדבר היחיד שכדאי להימנע ממנו הוא מעבד תמלילים: Word ו-Google Docs שומרים עיצוב ופריסה במקום טקסט פשוט, ואף אחד מהם אינו מייצר קובץ שהייבוא יכול לקרוא.
הקלידו את ההערה
שימו את הכותרת בשורה הראשונה עם # לפניה, השאירו שורה ריקה, וכתבו את ההערה מתחת. זה כבר קובץ שלם ותקין. אם אתם מעדיפים לא לכתוב שורת כותרת בכלל, ייעשה שימוש בשם הקובץ במקום.
שמרו אותו כשהוא מסתיים ב-.md
קראו לו איך שתרצו — ההערה שלי.md. ב-Windows פנקס הרשימות שומר .txt אלא אם תשנו קודם את «Save as type» ל-«All Files», וזו הטעות הנפוצה ביותר. ב-Mac בחרו Format ואז Make Plain Text לפני השמירה.
הוסיפו את השורה שמניחה אותה על פסוק
ממש בראש הקובץ, מעל כל דבר אחר, כתבו שורה של שלושה מקפים, אחר כך publication: Matthew 26:39, ואז שוב שלושה מקפים. ההערה קשורה עכשיו לאותו פסוק. אם תשמיטו את זה, ההערה עדיין תיובא — היא פשוט תגיע בלי קישור.
ייבאו אותה אל תוך גיבוי
ב-JW Library היכנסו ל״לימוד אישי״, פתחו את תפריט שלוש הנקודות, בחרו ״גיבוי ושחזור״ וצרו גיבוי. טענו את הקובץ הזה ב-jwsync.org, ב״סייר הלימוד״, לחצו על ״ייבוא Markdown״, בחרו את קובצי ה-.md שלכם, וקראו את הסיכום שמוצג לפני שנכתב משהו. אחר כך לחצו על ״ייצוא .jwlibrary״ ושחזרו את הקובץ הזה ב-JW Library.
הקובץ הקצר ביותר שעובד
קובץ שאין בו אלא טקסט הוא כבר הערה תקינה. זה הכול:
# הכוס שעליה התפלל תפילתו מראה כניעה, לא חוסר רצון.
השורה שמתחילה ב-# הופכת לכותרת ההערה, וכל מה שמתחתיה הופך לגוף ההערה. הקובץ הזה מיובא בלי טרוניה. הוא פשוט מגיע כהערה עצמאית, בין ההערות שלכם ולא קשור לפסוק.
יצירת הקובץ ב-Windows
פתחו את פנקס הרשימות, הקלידו את ההערה, ואז בחרו File ו-Save as. לפני השמירה שנו את «Save as type» מ-«Text Documents» ל-«All Files» — בלי הצעד הזה פנקס הרשימות מוסיף .txt בשקט ונשאר לכם ההערה שלי.md.txt, שהייבוא לא יראה. אחר כך הקלידו את השם כשהוא מסתיים ב-.md. ייתכן ש-Windows יזהיר אתכם ששינוי הסיומת עלול להפוך את הקובץ לבלתי שמיש; דווקא האזהרה הזאת היא הסימן שעשיתם נכון.
יצירת הקובץ ב-Mac
פתחו את TextEdit ובחרו Format ואז Make Plain Text לפני שאתם מקלידים משהו בכלל. TextEdit נפתח במצב טקסט מעוצב ושומר .rtf, שאינו קובץ טקסט כלל. ברגע שהוא במצב טקסט פשוט, בחרו File ו-Save, ותנו לשם להסתיים ב-.md. אם macOS מציע להוסיף .txt, סרבו.
יצירת הקובץ בטלפון או בטאבלט
כל אפליקציה שיודעת לשמור או לייצא Markdown מתאימה — Obsidian, Bear, iA Writer, Joplin, Markor ב-Android. אפליקציות הפתקים המובנות ב-iPhone וב-Android בדרך כלל אינן יודעות לשמור קובץ .md, ולכן בטלפון הדרך הרגילה היא אחת מהאפליקציות האלה, או פשוט לכתוב במחשב. בשעת הייבוא אפשר לבחור כמה קבצים שתרצו בבת אחת, ותיקייה שלמה אפשר לדחוס ולמסור כקובץ .zip יחיד.
השורה האחת שמניחה הערה על פסוק
כל מה שאומר לייבוא לאן ההערה שייכת נמצא בבלוק קטן ממש בראש הקובץ, בין שתי שורות של שלושה מקפים. הוא נקרא front matter, ולרוב ההערות הוא באורך שורה אחת:
--- publication: Matthew 26:39 --- # הכוס שעליה התפלל תפילתו מראה כניעה, לא חוסר רצון.
ההערה הזאת קשורה עכשיו למתי כ״ו:ל״ט. היא מופיעה ב-JW Library בזמן שאתם קוראים את אותו פסוק, בדיוק כאילו כתבתם אותה שם בתוך האפליקציה.
איך לכתוב את ההפניה כך שתובן
כתבו את שם הספר באנגלית, גם כשההערה עצמה בשפה אחרת: Matthew ולא מתי. גם הקיצורים שאנשים באמת מקלידים מובנים — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. בין הפרק לפסוק אפשר להשתמש בנקודתיים, בנקודה או באות v, ולכן John 3:16, John 3.16 ו-1 Cor 13 v4 פירושם אותו דבר, והרווחים אינם חובה, כך ש-1Cor13:4 בסדר גם הוא. טווח כמו Matthew 26:39-41 מניח את ההערה על הפסוק הראשון, ל״ט, משום שהערה ב-JW Library נקשרת לנקודה אחת בטקסט ולא למקטע.
הקובץ המלא, עם כותרת, תאריך ותוויות
יש עוד שלוש שורות זמינות אם תרצו בהן, וכולן אינן חובה:
--- title: הכוס שעליה התפלל date: 2026-08-15 tags: [לימוד, גת שמנים] publication: Matthew 26:39 --- תפילתו מראה כניעה, לא חוסר רצון.
title עושה בדיוק את מה שעושה הכותרת עם #, כך שדי באחד מהשניים. date קובע את תאריך ההערה במקום להשאיר את היום שבו ייבאתם. tags הופכות לתוויות אמיתיות ב-JW Library שאפשר לסנן לפיהן, ותווית שכבר יש לכם נעשה בה שימוש חוזר במקום שתשוכפל. את שורת tags אפשר לכתוב גם כך: לימוד, גת שמנים בלי סוגריים, או #לימוד #גתשמנים, או כרשימה עם מקפים בשורות נפרדות מתחתיה — כל ארבע הצורות נקראות אותו דבר.
הערה אחת לכל קובץ
כל קובץ .md הופך להערה אחת. אין דרך להכניס כמה הערות לקובץ אחד ולגרום להן להיפרד, משום ששום דבר בקובץ Markdown אינו מסמן באופן אמין היכן הערה אחת נגמרת והבאה מתחילה — כותרת באמצע הדרך יכולה להיות הערה שנייה ויכולה להיות כותרת משנה של הראשונה, וטעות בניחוש תפזר את מה שכתבתם. לכן כתבו קובץ אחד לכל הערה, ואז בחרו את כולם יחד בשעת הייבוא, או דחסו את התיקייה ובחרו את קובץ ה-.zip.
העיצוב שמגיע שלם
פסקאות, מעברי שורה, מודגש, נטוי ורשימות תבליטים מגיעים אל JW Library כעיצוב אמיתי. כותרות שאחרי הראשונה הופכות לפסקאות רגילות. כל מה ש-Markdown יודע לבטא והערה ב-JW Library אינה יודעת — טבלאות, תמונות, קישורים, בלוקי קוד — מצטמצם לטקסט שלו, כך שהמילים שורדות גם היכן שהפריסה אינה יכולה ללכת אחריהן.
אם אתם כבר כותבים ב-Obsidian
קובצי Obsidian הם Markdown ממילא, ולוח המאפיינים שלו כותב בדיוק את ה-front matter המתואר כאן: הוסיפו מאפיין בשם publication עם הערך Matthew 26:39 וההערה תנחת שם. המאפיין tags של Obsidian עצמו נקרא כ-tags. קישורים בסוגריים מרובעים כפולים והערות משובצות מצטמצמים לטקסט שלהם, שכן להערה ב-JW Library אין לאן להפנות אותם. אפשר לבחור את קובצי ה-.md של תיקייה שלמה בייבוא אחד, או לדחוס את התיקייה ולמסור את ה-.zip.
אם אתם כבר כותבים ב-Notion
Notion יודע לייצא Markdown: פתחו את תפריט העמוד, בחרו Export, וסמנו «Markdown & CSV». מה שיוצא הוא .zip, והייבוא מקבל אותו כמות שהוא. Notion כותב את כותרת העמוד ככותרת ואת המאפיינים שלו עצמו כשורות רגילות מתחת, ושדות שהייבוא אינו מכיר מתעלמים מהם במקום להתייחס אליהם כשגיאה — כך שכדי להניח הערה על פסוק, הוסיפו בעצמכם שורת publication בראש הקובץ המיוצא.
דברים שאינכם צריכים לקלוע אליהם
אותיות גדולות בשמות השדות אינן משנות. הרווח שאחרי הנקודתיים יכול להיעדר. רווחים וטאבים מיותרים מתעלמים מהם, וכך גם ממירכאות סביב ערך ומהערה שנכתבה אחרי #. סופי שורה של Windows אינם מפריעים. אתם יכולים אפילו להשמיט לגמרי את שורות ה--- ולהתחיל את הקובץ ישר בשדות, כל עוד השורה הראשונה ממש היא אחד מהם. ואם תשגו בכתיב של שם ספר — Mathew — הייבוא יאמר לכם שהוא קרא זאת כ-Matthew 26:39 וימתין שתסמנו את התיבה, במקום להכריע לבדו.
מה הייבוא לא יעשה לספרייה שלכם
ייבוא רק מוסיף. ההערות, ההדגשות, הסימניות והתוויות שכבר נמצאות בגיבוי שלכם אינן נוגעות, והקובץ שאתם טוענים אינו משתנה לעולם — בסוף אתם מורידים .jwlibrary חדש ואותו משחזרים. הערה שהכותרת, הטקסט והמיקום שלה תואמים כולם למשהו שכבר נמצא בגיבוי מדולגת, ולכן ייבוא אותם קבצים פעמיים אינו מכפיל דבר. כל מה שייבוא מוסיף הוא צעד אחד של ״בטל״, ולהערות המיובאות יש תווית Imported, כך שתוכלו למצוא אותן, לסנן לפיהן או למחוק אותן כקבוצה בהמשך. שום דבר מזה אינו עוזב את המכשיר שלכם.
שאלות נפוצות
- האם עליי ללמוד Markdown קודם?
- לא. קובץ של משפטים רגילים הוא כבר הערה תקינה. Markdown נכנס לתמונה רק אם תרצו מודגש, נטוי או תבליטים, וגם אז מדובר בשתי כוכביות סביב מילה למודגש ובמקף בתחילת שורה לתבליט.
- האם שם הקובץ משנה?
- רק כשלקובץ אין כותרת משלו. אם אין שורת title: ואין כותרת עם #, שם הקובץ מסודר ומשמש במקומה, כך ש-הכוס-שעליה-התפלל.md הופך להערה בשם ״הכוס שעליה התפלל״. חוץ מזה קראו לקובץ איך שתרצו.
- מה אם שמרתי אותו כ-.txt בטעות?
- שנו את השם כך שיסתיים ב-.md וייבאו שוב — אין צורך לשנות דבר בתוכן. ב-Windows ייתכן שתצטרכו קודם להפעיל את סיומות שמות הקבצים בתפריט View של סייר הקבצים, אחרת הסיומת מוסתרת מכם.
- אפשר לכתוב את שם הספר בשפה שלי?
- בשלב זה לא. שמות הספרים מזוהים באנגלית, וכך גם כותב אותם ייצוא ה-Markdown של האתר הזה. את ההערה עצמה כתבו בכל שפה שתרצו; רק שורת ההפניה זקוקה לשם האנגלי. אם אינכם רוצים בכך, השמיטו את ההפניה והניחו את ההערה ביד אחר כך.
- אפשר לשים יותר מהערה אחת בקובץ אחד?
- לא — כל קובץ הופך להערה אחת. בחרו כמה קבצים שתרצו בייבוא אחד, או דחסו את התיקייה ובחרו את קובץ ה-.zip.
- האם זה ישנה את ההערות שכבר יש לי?
- לא. ייבוא רק מוסיף. ההערות הקיימות שלכם אינן נוגעות, והגיבוי שאתם טוענים אינו משתנה לעולם: בסוף אתם מורידים קובץ חדש ואתם מחליטים אם לשחזר אותו.
- מה קורה אם אשמיט את שורת ההפניה?
- ההערה עדיין תיובא. היא תגיע כהערה עצמאית בספרייה שלכם ולא קשורה לפסוק — וזה בדיוק מה שהערה על נאום, על שיחה או על מחשבה אישית רוצה בדרך כלל.