የ Markdown አገባብ እና የሰነድ ለውጥ አስፈላጊነት
Markdown ቀላል እና ለማንበብ ግልጽ በሆነ መንገድ ጽሑፎችን ለመቅረጽ የሚያገለግል የአጻጻፍ ስልት ነው። ይህ አገባብ ጸሐፊዎች የጽሑፍ ቅርጸቶችን በቀላሉ እንዲያደራጁ ይረዳል። ይሁን እንጂ በተለያዩ የሥራ መስኮች እና መድረኮች ላይ ሰነዶችን ለማጋራት የቅርጸት ለውጥ ማድረግ አስፈላጊ ይሆናል። ሪፖርቶችን፣ መመሪያዎችን፣ ማስታወሻዎችን ወይም ጽሑፎችን ለተጠቃሚዎች በተለመደው የቢሮ ፋይል ቅርጸት (DOCX) ወይም በድረ-ገጽ ቅርጸት (HTML) ማቅረብ ሰነዶቹ በተለያዩ መሣሪያዎች ላይ በተገቢው መንገድ እንዲነበቡ ያደርጋል። ይህ መሣሪያ Markdown ጽሑፎችን በቀጥታ ወደ Word ሰነድ ወይም ንጹህ HTML ለመቀየር ያገለግላል።
የ Markdown አወቃቀር ወደ Word ሰነድ አቀማመጥ
የማይክሮሶፍት ዎርድ (Word) ሰነዶች የራሳቸው የሆነ ውስብስብ የፋይል አወቃቀር አላቸው። ይህ መሣሪያ በ Markdown ውስጥ የተጻፉትን መዋቅሮች በቀጥታ ወደ Word ሰነድ (DOCX) አካላት ይለውጣል። በለውጥ ሂደቱ ውስጥ የሚከተሉት የ Markdown አወቃቀሮች ወደ Word ሰነድ ይሸጋገራሉ፦
- ርዕሶች (Headings): ከ H1 እስከ H6 ያሉ ርዕሶች በ Word ሰነድ ውስጥ ተገቢውን የደረጃ ቅደም-ተከተል ይይዛሉ።
- ዝርዝሮች (Lists): ነጥብ ያለባቸው እና በቁጥር የተደረደሩ ዝርዝሮች።
- ሰንጠረዦች (Tables): መረጃዎችን በረድፍ እና በአምድ የሚያሳዩ ሰንጠረዦች።
- አገናኞች (Links): በሰነዱ ውስጥ የሚገኙ ተጫኝ የድር አድራሻዎች።
- የኮድ ብሎኮች (Code blocks): የፕሮግራም ኮዶች የሚቀመጡባቸው ልዩ ክፍሎች።
- ማጉያዎች (Emphasis): በደማቅ ወይም በሰያፍ የተጻፉ ጽሑፎች።
- የተግባር ዝርዝሮች (Task lists): መከናወን ያለባቸውን ተግባራት የሚያሳዩ ሳጥኖች።
መሣሪያው ለሚወርደው የ Word ፋይል ስም የሚወስደው በ Markdown ጽሑፍዎ ውስጥ ከሚገኘው የመጀመሪያው የ H1 ርዕስ ላይ በመነሳት ነው።
የንጹህ HTML ጥቅሞች እና የደህንነት አሠራር
"ንጹህ HTML" ማለት አላስፈላጊ የሆኑ የቅጥ ኮዶች (inline styles) ወይም ውስብስብ ስክሪፕቶች የሌሉበት፣ ደረጃውን የጠበቀ የድረ-ገጽ ኮድ ማለት ነው። ይህ መሣሪያ የሚያመነጨው HTML ቀላል እና ራሱን የቻለ ነጠላ ፋይል ነው።
በደህንነት ረገድ፣ በ Markdown ጽሑፍዎ ውስጥ ጥሬ የ HTML ኮዶችን ካካተቱ፣ መሣሪያው እነዚህን ኮዶች በ HTML ኤክስፖርት ውስጥ ከመታየታቸው በፊት ደህንነታቸው የተጠበቀ (escaped) ያደርጋቸዋል። በተጨማሪም፣ በቅድመ-ዕይታው እና በወጣው HTML ውስጥ የሚካተቱ ማናቸውም የድር አገናኞች (links) የ noopener noreferrer ባህሪን ይይዛሉ። ይህ አሠራር አገናኞቹ ሲከፈቱ የድረ-ገጹን ደህንነት ለመጠበቅ ይረዳል።
በአሳሽ ውስጥ የሚከናወን የአገር ውስጥ ሂደት
የዚህ መሣሪያ ዋነኛ የቴክኖሎጂ ባህሪ የጽሑፍ ማቀነባበር ሂደቱ ሙሉ በሙሉ በተጠቃሚው የድር አሳሽ (browser) ውስጥ መከናወኑ ነው። የእርስዎ Markdown በአሳሽ ውስጥ ነው የሚሰራው። ምንም ነገር ወደ BroBroGo አይሰቀልም።
የሰነዱ ቅድመ-ዕይታ፣ የ HTML ኤክስፖርት እና የ Word ሰነድ ማመንጨት ተግባራት በሙሉ የሚከናወኑት በአገር ውስጥ (locally) ነው። ይህ አሠራር መረጃዎች ወደ ውጭ አገልጋይ (server) እንዳይላኩ ይከላከላል።
Markdown ለመለወጥ መከተል ያለባቸው ምርጥ ልምዶች
ከ Markdown ወደ Word ወይም HTML በሚደረግ ለውጥ ላይ ምርጥ ውጤት ለማግኘት የሚከተሉትን ደንቦች መከተል ይመከራል፦
- የመጀመሪያ ርዕስ መጠቀም፦ የ Word ፋይል ስም በራስ-ሰር እንዲወሰን ለማድረግ በሰነዱ መጀመሪያ ላይ የ H1 ርዕስ (በ
#ምልክት የሚጀምር) ይጠቀሙ። - የቁምፊ ገደብን ማክበር፦ ለአገር ውስጥ Word ኤክስፖርት የቁምፊ መጠን ገደብ አለ። ጽሑፉ ከገደቡ በላይ ከሆነ "ይህ Markdown ለአገር ውስጥ Word ኤክስፖርት በጣም ትልቅ ነው። እባክዎ ከ
{max}ቁምፊዎች በታች ያድርጉት።" የሚል መልዕክት ይታያል። - ባዶ ሰነድ አለመላክ፦ በማረሚያው ውስጥ ምንም ጽሑፍ ሳይኖር ኤክስፖርት ለማድረግ ሲሞክሩ "የሚላክ ምንም ነገር የለም — መጀመሪያ ጥቂት Markdown ጽሑፍ ይጻፉ።" የሚል ማስጠንቀቂያ ያያሉ።
ተደጋግመው የሚነሱ ጥያቄዎች (FAQ)
የምጽፈው Markdown ወደ ድረ-ገጽ ይሰቀላል?
አይደለም። ቅድመ-ዕይታው፣ የHTML ኤክስፖርቱ እና የWord ሰነድ ማመንጨቱ ሁሉም በአሳሽዎ ውስጥ በአገር ውስጥ ነው የሚሰሩት።
የWord ኤክስፖርቱ ምን ምን ነገሮችን ይይዛል?
የDOCX ፋይሉ እንደ ርዕሶች፣ ዝርዝሮች፣ ሰንጠረዦች፣ አገናኞች፣ የኮድ ብሎኮች፣ ማጉያዎች እና የተግባር ዝርዝሮች ያሉ የተለመዱ የMarkdown አወቃቀሮችን ይይዛል።
የHTML ኤክስፖርቱ ደህንነታቸው ያልተጠበቁ ስክሪፕቶችን ያካትታል?
አይደለም። በMarkdownዎ ውስጥ ያሉ ጥሬ የHTML ኮዶች ከመታየታቸው በፊት ደህንነታቸው የተጠበቀ (escaped) ይደረጋል፣ እና የሚወርደው HTML ቀላል ራሱን የቻለ ሰነድ ነው።
የመለወጥ ሂደት ሳይሳካ ሲቀር ምን ማድረግ ይኖርብኛል?
የመለወጥ ሂደት ካልተሳካ መሣሪያው "መለወጥ አልተሳካም። አነስ ያለ የMarkdown ሰነድ ይሞክሩ።" የሚል መልዕክት ያሳያል። የጽሑፉን መጠን በመቀነስ ድጋሚ መሞከር ይችላሉ።
የማረሚያው ሰሌዳ ሲጸዳ ምን ይከሰታል?
የማረሚያውን ሰሌዳ ሲያጸዱ "ማረሚያው ጸድቷል።" የሚል ሁኔታ የሚታይ ሲሆን የቁምፊዎች ቆጠራም ወደ 0 ይመለሳል። በማረሚያው ውስጥ ምንም ጽሑፍ በሌለበት ጊዜ "የተቀረጸው ቅድመ-ዕይታዎ እና HTML እዚህ ይታያሉ።" የሚለው መልዕክት በቅድመ-ዕይታ ቦታው ላይ ይተካል።