Markdown 101: เปลี่ยนข้อความให้มีโครงสร้างMarkdown 101: words become structure
เข้าใจภาพรวมของ Markdown แล้วเริ่มเขียนหัวข้อ ย่อหน้า ตัวหนา และตัวเอียงแบบไม่สับสนกับ syntaxLearn the Markdown mental model, then write headings, paragraphs, bold text, and italic text without fighting the syntax.
Markdown is plain text with tiny signals for structure.
You do not design every pixel. You write a document that says:
- this is a heading
- this is a paragraph
- this phrase is important
- this word needs emphasis
Then GitHub, Notion, a blog engine, or a preview tool turns that structure into HTML.
The mental model
Markdown is not a replacement for a designer. It is a fast way to mark the meaning of text.
The useful question is not "how do I make this look blue?" The useful question is:
What job does this line do in the document?
If the line names a section, make it a heading. If it explains an idea, leave it as a paragraph. If one phrase matters, make that phrase bold.
Headings
Headings use # at the start of a line.
# Project Name
## Installation
### Requirements
Use one # for the page title. Use ## for major sections. Use ### for sub-sections.
Avoid jumping from # straight to ####. A README should feel like an outline, not a pile of decorated text.
Paragraphs
A paragraph is just text with a blank line before the next paragraph.
This tool helps a team turn rough meeting notes into a clean summary.
It is designed for weekly project updates, not legal records.
Line breaks inside one paragraph are usually ignored by Markdown renderers. Use a blank line when you mean "new paragraph."
Bold and italic
Use bold for strong importance:
Run **one command at a time** when you are still learning.
Use italic for light emphasis:
This step is *optional* if you already have Node installed.
You can combine them, but do it rarely:
Do ***not*** paste secrets into a public README.
Your first Markdown block
Copy this into any Markdown previewer:
# My First README
This project is a small practice space for learning Markdown.
## Goal
Write a README that is **clear enough for a teammate** to understand.
## Status
This is *not finished yet*, but the structure is ready.
The important part is not that the text is beautiful. The important part is that the document now has a shape.
Checkpoint
Before moving on, make sure you can answer these:
- What does one
#mean? - Why does a blank line matter?
- When should you use bold instead of italic?
Markdown คือข้อความธรรมดาที่ใส่สัญญาณเล็กๆ เพื่อบอกโครงสร้าง
เราไม่ได้ออกแบบทุก pixel เอง แต่เราเขียนเอกสารให้ระบบเข้าใจว่า:
- บรรทัดนี้คือหัวข้อ
- ช่วงนี้คือย่อหน้า
- วลีนี้สำคัญ
- คำนี้ต้องการเน้น
จากนั้น GitHub, Notion, ระบบ blog หรือเครื่องมือ preview จะเอาโครงสร้างนี้ไป render เป็น HTML ให้
ภาพจำที่ควรมี
Markdown ไม่ได้มาแทนนักออกแบบครับ
มันคือวิธีเขียนที่เร็วมากสำหรับบอก "ความหมาย" ของข้อความ
คำถามที่มีประโยชน์ไม่ใช่ "ทำให้บรรทัดนี้เป็นสีฟ้ายังไง?"
คำถามที่มีประโยชน์กว่าคือ:
บรรทัดนี้ทำหน้าที่อะไรในเอกสาร?
ถ้าบรรทัดนั้นตั้งชื่อ section ให้ใช้ heading ถ้าบรรทัดนั้นอธิบายไอเดีย ให้ปล่อยเป็น paragraph ถ้ามีวลีหนึ่งที่สำคัญจริงๆ ค่อยทำเป็นตัวหนา
หัวข้อ
หัวข้อใช้ # ที่ต้นบรรทัด
# Project Name
## Installation
### Requirements
ใช้ # หนึ่งตัวสำหรับชื่อหน้า ใช้ ## สำหรับ section ใหญ่ และใช้ ### สำหรับ section ย่อย
อย่ากระโดดจาก # ไป #### ทันที README ที่ดีควรรู้สึกเหมือน outline ที่อ่านตามได้ ไม่ใช่ข้อความที่ตกแต่งกระจัดกระจาย
ย่อหน้า
ย่อหน้าคือข้อความธรรมดาที่มีบรรทัดว่างคั่นก่อนย่อหน้าถัดไป
This tool helps a team turn rough meeting notes into a clean summary.
It is designed for weekly project updates, not legal records.
ถ้าขึ้นบรรทัดใหม่เฉยๆ หลาย renderer จะยังมองว่าเป็น paragraph เดิมอยู่ ให้เว้นบรรทัดว่างเมื่อคุณต้องการเริ่มย่อหน้าใหม่จริงๆ
ตัวหนาและตัวเอียง
ใช้ตัวหนาเมื่อเป็นเรื่องสำคัญ:
Run **one command at a time** when you are still learning.
ใช้ตัวเอียงเมื่อเป็นการเน้นเบาๆ:
This step is *optional* if you already have Node installed.
จะใช้พร้อมกันก็ได้ แต่ควรใช้ให้น้อย:
Do ***not*** paste secrets into a public README.
Markdown ชิ้นแรกของคุณ
ลองคัดลอกตัวอย่างนี้ไปใส่ previewer:
# My First README
This project is a small practice space for learning Markdown.
## Goal
Write a README that is **clear enough for a teammate** to understand.
## Status
This is *not finished yet*, but the structure is ready.
จุดสำคัญไม่ใช่ว่าประโยคต้องสวยที่สุด แต่คือเอกสารเริ่มมีรูปร่างแล้ว
จุดเช็ก
ก่อนข้ามไปบทต่อไป ลองตอบให้ได้ว่า:
#หนึ่งตัวหมายถึงอะไร?- ทำไมบรรทัดว่างถึงสำคัญ?
- เมื่อไหร่ควรใช้ตัวหนาแทนตัวเอียง?
บทถัดไป: Markdown 102 - list, quote และ code
เข้าสู่ระบบเพื่อบันทึกความคืบหน้าSign in to track your progress
เข้าสู่ระบบSign in→