ነጻ መለወጫ

ምልክት ማድረጊያ ወደ HTML መለወጫ

የማርክ ዳውን ጽሑፍ ወደ ምርት-ዝግጁ ኤችቲኤምኤል ኮድ ከቀጥታ ቅድመ እይታ ድጋፍ ጋር ቀይር።

ስላዚህ መሳሪያ

ማርክ ዳውን በ 2004 በጆን ግሩበር የተፈጠረ ቀላል ክብደት ያለው የማርክ ማድረጊያ ቋንቋ ፀሃፊዎች የተዋቀሩ ኤችቲኤምኤልን በግልፅ የፅሁፍ ውል በመጠቀም እንዲያመርቱ ለማስቻል ነው፡ ሃሽ ቁምፊዎች ለርዕስ፣ ለአጽንኦት ምልክቶች፣ ለዝርዝሮች ሰረዞች፣ ለኮድ ገብተው የተቀመጡ ብሎኮች። ቅርጸቱ ለ README ፋይሎች፣ የቴክኒክ ሰነዶች፣ የብሎግ ረቂቆች፣ የማይንቀሳቀስ ጣቢያ ጀነሬተሮች፣ እና ጽሑፉ እንደ ግልጽ ጽሁፍ እና እንደ ተተረጎመ ውጤት የሚነበብበት ማንኛውም አውድ ነባሪ ሆኗል። ማርክ ዳውን ወደ ኤችቲኤምኤል መለወጥ ምንጩን ወደ ድረ-ገጽ የሚቀይረው የማሳያ ደረጃ ነው።

ይህ መቀየሪያ በጃቫ ስክሪፕት ውስጥ በብዛት ተቀባይነት ያለው የማርካውንድ ማሳያን በመጠቀም ምልክት የተደረገበትን ቤተ-መጽሐፍት ይጠቀማል። ምልክት የተደረገበት CommonMark እና GitHub Flavored Markdown (GFM)ን ይደግፋል፣ ይህም ማለት ሰንጠረዦች፣ የታጠሩ የኮድ ብሎኮች፣ የተግባር ዝርዝሮች፣ አድማ እና ራስ-ማገናኘት ከመደበኛ የማርክ ታች ባህሪያት በተጨማሪ በትክክል ይሰራሉ።

ውፅዓት ግልጽ ኤችቲኤምኤል ነው - የትርጓሜ መለያዎች ለርዕሶች፣ አንቀጾች፣ ዝርዝሮች፣ አገናኞች እና ምስሎች፣ በተጨማሪም የክፍል መንጠቆዎች ለኮድ ብሎኮች የአገባብ ማድመቂያ መሳሪያዎች የሚጠብቋቸው። ውጤቱ በንጽህና ወደ ማንኛውም ሲኤምኤስ ይለጠፋል፣ በማይንቀሳቀስ ጣቢያ ጀነሬተሮች ውስጥ ይካተታል ወይም ራሱን የቻለ .html ሆኖ ያገለግላል። ምንም CSS ወይም JavaScript አልተጨመረም; ውጤቱን ማበጀት ለታችኛው ተፋሰስ አውድዎ የተተወ ነው።

ለምን Markdown ወደ HTML መቀየር

Markdown ፀሐፊዎች እና ገንቢዎች የሚመርጡት ቅርጸት ነው; ኤችቲኤምኤል የአሳሾች ቅርጸት ነው። አብዛኛዎቹ የማይንቀሳቀሱ የሳይት ጀነሬተሮች እና የሲኤምኤስ መድረኮች ከትዕይንቱ በስተጀርባ ማርክዳውን ወደ ኤችቲኤምኤል ይለውጣሉ፣ ነገር ግን አንዳንድ ጊዜ ልወጣን እንደ ገለልተኛ እርምጃ ያስፈልግዎታል - የማርክ ዳውንድ ድጋፍ ወደሌለው ሲኤምኤስ መለጠፍ፣ ኤችቲኤምኤልን ለኢሜይሎች ማመንጨት፣ ፈጣን ቅድመ እይታን ማዘጋጀት ወይም ለቀጣይ ሂደት የተሰራውን ውጤት ማውጣት።

ኤችቲኤምኤል እንዲሁ በመጨረሻ በአሳሽ ውስጥ ለሚታየው ለማንኛውም ይዘት ቀኖናዊ ቅርጸት ነው። ከማርክ ዳውድ ረቂቆች የተገነቡ የኢሜል ጋዜጣዎች፣ በትላልቅ የኤችቲኤምኤል አፕሊኬሽኖች ውስጥ የተካተቱ የሰነድ ገፆች እና ኤችቲኤምኤል ከንፁህ ልወጣ ተጠቃሚ ይሆናሉ ብለው በሚጠብቁ አርታኢዎች ውስጥ የተለጠፉ የብሎግ ልጥፎች።

እንዴት ይጠቀሙ

Markdown ለጥፍ፣ HTML ያግኙ።

  1. የእርስዎን Markdown ያክሉ: የማርክዳውን ጽሑፍ ወደ ግቤት ቦታ ይለጥፉ ወይም የ.md ፋይል ይጣሉ። ሁለቱም መደበኛ Markdown እና GitHub Flavored Markdown አገባብ ይሰራሉ።
  2. ቀይር: ምልክት የተደረገበት ማርክዳውን ወደ AST ይተነተን እና HTML ያወጣል። መደበኛ የውስጠ-መስመር ክፍሎች (አጽንዖት፣ ጠንካራ፣ አገናኞች፣ ኮድ፣ ምስሎች)፣ የማገጃ ክፍሎች (ርዕሶች፣ አንቀጾች፣ ዝርዝሮች፣ የብሎክ ጥቅሶች) እና የጂኤፍኤም ቅጥያዎች (ሠንጠረዦች፣ የታጠረ ኮድ፣ የተግባር ዝርዝሮች፣ ራስ-አገናኞች) ሁሉም በትክክል ይሰጣሉ።
  3. ቅድመ እይታ: በቅድመ-እይታ ፓነል ውስጥ የተሰራውን HTML ይፈትሹ። የኮድ ብሎኮችን፣ ሠንጠረዦችን እና ሌሎች ውስብስብ አካላት እንደተጠበቀው እንደሚታዩ ያረጋግጡ።
  4. ቅዳ ወይም አውርድ: ወደ ሲኤምኤስ ለመለጠፍ ኤችቲኤምኤልን ወደ ቅንጥብ ሰሌዳ ይቅዱ ወይም ለብቻው ለመጠቀም እንደ .html ያስቀምጡ። ውጤቱ የፍቺ HTML5 ያለ የመስመር ውስጥ ቅጦች ነው።

የተለመዱ የአጠቃቀም ጉዳዮች

ቴክኒካዊ ዝርዝሮች

ምልክት የተደረገበት ባለ ሁለት ማለፊያ አርክቴክቸር ይጠቀማል። ሌክሰሩ ግቤቱን በብሎክ-ደረጃ ቶከኖች (ርእሶች፣ አንቀጾች፣ ዝርዝሮች፣ ኮድ ብሎኮች) እና የመስመር ላይ ቶከኖች (አጽንዖት፣ አገናኞች፣ ምስሎች) ውስጥ ያስቀምጣል። ተንታኙ የማስመሰያ ዥረቱን ይራመዳል እና ኤችቲኤምኤል ያስወጣል፣ ለእያንዳንዱ የማስመሰያ አይነት ሰሪ መንጠቆዎችን ይጠቀማል።

GitHub Flavored Markdown ቅጥያዎች በነባሪነት ነቅተዋል፡ ሰንጠረዦች (የቧንቧ አገባብ በመጠቀም)፣ የታጠሩ የኮድ ብሎኮች (የቋንቋ ፍንጭ ያላቸው ባለሶስት የኋላ ምልክቶች)፣ የተግባር ዝርዝሮች (- [] እና - [x])፣ መትከያ (ድርብ እጥፎችን በመጠቀም) እና ዩአርኤል በራስ ማገናኘት። የኮድ ብሎኮች ለታችኛ ተፋሰስ አገባብ ማድመቂያ ከአማራጭ ቋንቋ ክፍል ጋር በቅድሚያ ተጠቅልሎ በኮድ ላይ ይለቃሉ።

የውጤት ንፅህና አጠባበቅ ለታችኛው ተፋሰስ ተጠቃሚዎች የተተወ ነው። ምልክት የተደረገበት ግብአቱ የሚያወጣውን ማንኛውንም ነገር፣ በማርክdown ውስጥ የተካተተውን ጥሬ HTML ጨምሮ። ያልታመነ ግብዓት ከተቀበሉ በአሳሽ ውስጥ ከማቅረባችሁ በፊት ውጤቱን በDOMPurify ወይም በተመሳሳይ HTML sanitizer ያስኪዱ።

ምርጥ ልምዶች

በተደጋጋሚ የሚጠየቁ ጥያቄዎች

MARKDOWN ወደ HTML መቀየር ይዘቱን ይቀይረዋል?
ይዘቱ በተቻለ መጠን በትክክል ተጠብቆ ይቆያል። ነገር ግን፣ አንዳንድ ቅርጸ-ተኮር ባህሪያት ቀጥተኛ አቻዎች ላይኖራቸው ይችላል፣ ስለዚህ ትንሽ የቅርጸት ልዩነቶች ሊከሰቱ ይችላሉ።
HTML ቅርጸት ለምን ጥቅም ላይ ይውላል?
HTML (HyperText Markup Language) በዋናነት ለድረ-ገጾች እና ለድር ይዘት ያገለግላል።
ማወቅ ያለባቸው ገደቦች አሉ?
እስከ 50MB የሚደርሱ ፋይሎች ይደገፋሉ። በጣም ትልቅ ወይም ውስብስብ ፋይሎችን ለማስኬድ ብዙ ጊዜ ሊወስድ ይችላል። ሁሉም ልወጣዎች በአሳሽዎ ውስጥ ይከናወናሉ፣ ስለዚህ የሂደቱ ፍጥነት በመሳሪያዎ ላይ ይወሰናል።
ይህ ልወጣ ደህንነቱ የተጠበቀ እና ግላዊ ነው?
አዎ። ሁሉም ሂደት በአሳሽዎ ውስጥ በአካባቢው ይከናወናል። የእርስዎ ውሂብ መቼም ቢሆን ከመሣሪያዎ አይወጣም - ምንም የአገልጋይ ጭነት የለም፣ ምንም የደመና ሂደት የለም፣ ምንም የውሂብ መሰብሰብ የለም።
ስሜት ገላጭ ምስሎች ይደገፋሉ?
ዩኒኮድ ኢሞጂ በቀጥታ ያልፋል (የልብ ስሜት ገላጭ ምስል መተየብ በውጤቱ ውስጥ ያለውን ልብ ያሳያል)። GitHub-style:emoji: አጭር ኮዶች በነባሪነት አይለወጡም; ከፈለጉ አንድ ቅጥያ ያክሉ።
የእኔ Markdown ወደ አገልጋይ ተሰቅሏል?
በአሳሽዎ ውስጥ ምልክት የተደረገባቸው ስራዎች; ልወጣው ሙሉ በሙሉ በመሣሪያዎ ላይ ይከሰታል።
ብጁ የቅጥ አሰራርን ወደ HTML ማከል እችላለሁ?
አዎ፣ ከተለወጠ በኋላ። ውጤቱ ግልጽ የፍቺ HTML ነው; የእራስዎን CSS በቅጥ አርዕስቶች፣ በኮድ ብሎኮች፣ በሰንጠረዦች እና በሌሎች አካላት ላይ ይተግብሩ።
የግርጌ ማስታወሻዎችን ይደግፋል?
መደበኛ CommonMark የግርጌ ማስታወሻ አገባብ አይገልጽም። አንዳንድ Markdown ቅጥያዎች [^1] የግርጌ ማስታወሻ አገባብ ይደግፋሉ; ይህ መቀየሪያ የግርጌ ማስታወሻዎችን የማያካትት GFMን ይከተላል።