วิธีสร้างและดูตัวอย่างไฟล์ Vim Markdown

Vim สามารถใช้เพื่อสร้าง แก้ไข และเรียกใช้ไฟล์มาร์กดาวน์ได้โดยตรงจากเทอร์มินัล ปลั๊กอินหลายตัวช่วยให้คุณสามารถพิมพ์มาร์กดาวน์และดูตัวอย่างผลลัพธ์ได้

คู่มือนี้จะสำรวจความสามารถของ Vim ในการสร้าง แก้ไข และดูตัวอย่างไฟล์มาร์กดาวน์

• การติดตั้งการพึ่งพา
• ข้อกำหนดเบื้องต้นในการดูตัวอย่าง Vim Markdown
• การติดตั้ง VimPlug Plugin Manager สำหรับ Vim
• การติดตั้งปลั๊กอินแสดงตัวอย่าง Markdown Live
• การสร้างไฟล์ Markdown ในกลุ่ม
• การดูตัวอย่างไฟล์ Vim Markdown
• ดูตัวอย่าง Vim Markdown ใน Terminal
• ส่งออกไฟล์ Markdown เป็นรูปแบบต่างๆ โดยใช้ Vim
• แผ่นโกง Markdown
• บทสรุป

บันทึก: สำหรับคำแนะนำในบทช่วยสอนนี้ ฉันใช้ Linux (Ubuntu 22.04)

Vim ไม่แสดงตัวอย่างไฟล์มาร์กดาวน์นอกกรอบ ต้องมีการตั้งค่าที่สมบูรณ์เพื่อแสดงไฟล์มาร์กอัป หากต้องการเปิดใช้งานการแสดงตัวอย่างไฟล์มาร์กดาวน์แบบสดใน Vim จำเป็นต้องติดตั้งการขึ้นต่อกันและข้อกำหนดเบื้องต้นบางอย่าง

การติดตั้งการพึ่งพา

หากต้องการเรียกใช้ไฟล์มาร์กดาวน์โดยใช้ Vim คุณต้องติดตั้งโปรแกรมต่อไปนี้บน Linux:

• โหนด js
• เอ็นพีเอ็ม

หากต้องการติดตั้ง Node.js บน Linux ให้ใช้:

จากนั้นคุณจะต้องติดตั้ง Node Package Manager (npm) โดยใช้คำสั่งต่อไปนี้:

หากต้องการตรวจสอบเวอร์ชัน Node.js ให้ใช้ โหนด -v คำสั่งและสำหรับการใช้ตัวจัดการแพ็คเกจ เวลาบ่ายโมง -v . ที่ เวลา 22.00 น ใช้เพื่อติดตั้งเซิร์ฟเวอร์ mini Node.js ที่จำเป็นสำหรับปลั๊กอินดูตัวอย่างไฟล์ Vim markdown ที่แตกต่างกัน

ข้อกำหนดเบื้องต้นในการดู Vim Markdown

เพื่อเตรียม Vim สำหรับการเรนเดอร์ไฟล์มาร์กดาวน์ คุณต้องใช้ปลั๊กอิน วิธีที่ดีที่สุดในการติดตั้งปลั๊กอินไปยัง Vim คือการใช้ตัวจัดการปลั๊กอิน Vim สามารถติดตั้งตัวจัดการปลั๊กอินต่างๆ บน Vim ได้ เช่น VimPlug, Pathogen, Neobundle หรือ Vundle ฉันกำลังติดตั้ง VimPlug แต่ก็ขึ้นอยู่กับความชอบส่วนบุคคล

การติดตั้ง VimPlug Plugin Manager สำหรับ Vim

ขั้นแรกให้รันคำสั่งที่ระบุด้านล่าง:

คำสั่งข้างต้น –สร้าง-dirs สร้าง โหลดอัตโนมัติ ไดเร็กทอรีหากไม่มีอยู่และดาวน์โหลดไฟล์ VimPlug ที่นั่น

การติดตั้งปลั๊กอินแสดงตัวอย่าง Markdown Live

มีปลั๊กอินจำนวนมากที่ให้การแสดงตัวอย่างไฟล์มาร์กดาวน์แบบสด รายการปลั๊กอินดังกล่าวมีดังต่อไปนี้:

• เป็นกลุ่มทันที Markdown
• Livedown.Vim
• Mkdพรีวิว

ปลั๊กอินทั้งหมดทำงานได้อย่างมีประสิทธิภาพมาก สำหรับบทช่วยสอนนี้ ฉันจะติดตั้งปลั๊กอิน Vim-Instant-Markdown เนื่องจากปลั๊กอินจะเปิดเบราว์เซอร์เพื่อดูตัวอย่างไฟล์ทันทีที่คุณเปิดไฟล์มาร์กดาวน์ใน Vim

คลิกที่นี่เพื่อเปิดหน้าเว็บปลั๊กอิน VimAwesome Vim-Instant-Markdown และคัดลอกโค้ดสำหรับ VimPlug

เปิดไฟล์ vimrc ด้วยสิทธิ์ sudo:

ไม่แนะนำให้แก้ไขไฟล์ระบบ ดังนั้นให้สร้างไฟล์ vimrc เฉพาะผู้ใช้โดยใช้คำสั่งต่อไปนี้

วางบรรทัดต่อไปนี้ในไฟล์

คุณสามารถติดตั้งปลั๊กอินใดก็ได้โดยวางโค้ดปลั๊กอินไว้ระหว่าง เสียบสาย #begin() และ เสียบสาย#end() แท็กในไฟล์ vimrc บันทึกไฟล์โดยใช้ปุ่ม SHIFT+zz หรือใช้คำสั่ง :wq ในโหมดคำสั่ง Vim

ตอนนี้เปิดตัวแก้ไข Vim โดยใช้ไฟล์ เพราะ สั่งการและเรียกใช้ :เสียบปลั๊ก ในโหมดคำสั่ง

มันจะติดตั้งปลั๊กอินและคุณพร้อมที่จะสร้างไฟล์มาร์กดาวน์และดูตัวอย่างแบบสดในตัวแก้ไข Vim

การสร้างไฟล์ Markdown ในกลุ่ม

Vim ล่าสุดมีไวยากรณ์ไฟล์มาร์กดาวน์ที่เน้นนอกกรอบ

หากต้องการสร้างไฟล์มาร์กดาวน์ใน Vim ให้ใช้ไวยากรณ์ต่อไปนี้:

คุณสามารถใช้นามสกุลที่แตกต่างกันสำหรับไฟล์มาร์กดาวน์ได้ เช่น:

• แพทยศาสตร์
• เอ็มเคดี
• มาร์กดาวน์

มาสร้างไฟล์มาร์กดาวน์กันเถอะ

ในไฟล์ด้านบน เครื่องหมายแฮช (#, ##, ###) ใช้เพื่อเพิ่มส่วนหัวที่มีน้ำหนักต่างกัน สัญลักษณ์มากกว่า (>) ใช้เพื่อเพิ่ม blockquote และใช้เครื่องหมายถูก (`, “`) เพื่อเพิ่มคำสั่งหรือบล็อกโค้ด สำหรับองค์ประกอบไฟล์มาร์กดาวน์เพิ่มเติม โปรดดูเอกสารสรุปในส่วนต่อไปนี้

การดูตัวอย่างไฟล์ Vim Markdown

หากต้องการดูไฟล์มาร์กดาวน์ คุณต้องมีตัวเรนเดอร์ที่สามารถแปลไฟล์และให้เอาต์พุตตามคำแนะนำ เช่นเดียวกับไฟล์ HTML ที่ต้องใช้เว็บเบราว์เซอร์ในการแสดงผล ไฟล์มาร์กดาวน์ยังต้องมีแอปพลิเคชันในการดูด้วย

มีแอปตัวเรนเดอร์มากมายที่สามารถดูไฟล์มาร์กดาวน์ได้ สำหรับบทช่วยสอนนี้ เราได้ติดตั้งปลั๊กอิน Vim ที่สามารถช่วยให้เราแสดงตัวอย่างไฟล์มาร์กดาวน์แบบเรียลไทม์ได้

ดังนั้นเมื่อคุณเปิดไฟล์มาร์กดาวน์ใด ๆ ปลั๊กอิน Vim-Instant-Markdown จะเปิดเบราว์เซอร์ให้เป็นไฟล์มาร์กดาวน์เวอร์ชันที่แสดงผลตัวอย่างสดใน Vim

เมื่อคุณแก้ไขไฟล์ใน Vim ปลั๊กอินจะแปลคำแนะนำเกี่ยวกับรันไทม์และให้การแสดงตัวอย่างสดบนเบราว์เซอร์

ดูตัวอย่าง Vim Markdown ใน Terminal

ไฟล์มาร์กดาวน์สามารถอ่านได้ในเทอร์มินัลโดยใช้ตัวเรนเดอร์มาร์กดาวน์ต่างๆ เช่น Pandoc หรือ Glow มาติดตั้ง Glow โดยใช้ Snap บน Linux:

ตอนนี้หากต้องการดูไฟล์มาร์กดาวน์ในเทอร์มินัลให้ใช้:

อย่างไรก็ตาม โปรแกรมอ่านเหล่านี้ตีความองค์ประกอบ Markdown ในจำนวนจำกัดเท่านั้น และอาจไม่รองรับฟีเจอร์ทั้งหมด ในความคิดของฉัน การดูมาร์กดาวน์จากเทอร์มินัลไม่ใช่ตัวเลือกที่ดี

ส่งออกไฟล์ Markdown เป็นรูปแบบต่างๆ โดยใช้ Vim

คุณลักษณะที่ดีของไฟล์มาร์กดาวน์คือคุณสามารถส่งออกเป็นรูปแบบไฟล์ต่างๆ ได้ เช่น เอกสาร, PDF และ HTML เพื่อที่คุณจะต้องติดตั้งยูทิลิตี้ที่เรียกว่า pandoc

หากต้องการติดตั้ง pandoc บน Linux ให้ใช้:

สำหรับการแปลง PDF คุณอาจต้องใช้โปรแกรมอรรถประโยชน์เพิ่มเติมที่กล่าวถึงในคำสั่งข้างต้น

บันทึก: ตรวจสอบให้แน่ใจว่าได้บันทึกไฟล์ก่อนที่จะดำเนินการคำสั่งเพื่อส่งออกไฟล์มาร์กดาวน์เป็นรูปแบบอื่น

การแปลงไฟล์ Markdown เป็น HTML

ใช้คำสั่งที่ระบุด้านล่างเพื่อแปลงไฟล์มาร์กดาวน์เป็น HTML

บันทึก: โดยใช้ ! ลงนามคำสั่งภายนอกใด ๆ ที่สามารถดำเนินการได้ในโปรแกรมแก้ไข Vim

การแปลงไฟล์ Markdown เป็น PDF

PDF เป็นรูปแบบไฟล์ที่ได้รับการยอมรับอย่างกว้างขวาง ในการแปลงไฟล์มาร์กดาวน์เป็น PDF ให้ใช้คำสั่งด้านล่าง:

การแปลงไฟล์ Markdown เป็น Docx

Docx เป็นรูปแบบไฟล์อื่นที่สามารถแปลงไฟล์มาร์กดาวน์ได้

แทนที่ [ชื่อไฟล์] ในคำสั่งด้านบนพร้อมชื่อไฟล์ที่คุณต้องการแปลง

แผ่นโกง Markdown

องค์ประกอบ markdown ที่ใช้กันทั่วไปมีให้ในภาพต่อไปนี้:

บทสรุป

Vim เป็นตัวแก้ไขที่ทรงพลังซึ่งด้วยความช่วยเหลือของปลั๊กอินจึงกลายเป็นตัวเลือกที่ดียิ่งขึ้น Vim จัดเตรียมการเน้นไวยากรณ์พื้นฐานของไฟล์มาร์กดาวน์ เพื่อให้สามารถแก้ไขได้อย่างง่ายดายในตัวแก้ไข นอกจากนี้ หากต้องการดูตัวอย่างรูปแบบการแสดงผลของไฟล์ Markdown คุณจะต้องติดตั้งปลั๊กอิน เช่น Vim-Instant-Markdown ด้วยความช่วยเหลือของยูทิลิตี้ Linux เช่นไฟล์ pandoc markdown สามารถส่งออกเป็นรูปแบบไฟล์ต่างๆ