HedgeDoc - จด note ด้วย markdown

HedgeDoc - จด note ด้วย markdown

ทุกๆคนมีวิธีจด note กันยังไงบ้างครับ notepad? , google doc? , word? หรือใช้แอปออะไรกันบ้างครับ🧐 วันนี้ผมมีอีกหนึ่งระบบดีๆที่จะมาช่วยให้เราจด note และเปิดที่ไหนก็ได้อย่างง่ายดาย , แก้ไขพร้อมกันหลายคนได้ และที่สำคัญรองรับ markdown!! 🎉

HedgeDoc เป็นโปรเจคที่เคยเป็นทีมเดียวกันกับ HackMD แต่ตอนนี้แยกออกมาทำ โดยเป็น real-time collaborative markdown notes ที่อยู่บนเว็บไซต์ใช้ทรัพยากรน้อย ทำให้ใช้งานได้อย่างลื่นไหล

ฟีเจอร์หลักของ HedgeDoc

  • Web base - ใช้งานบนเว็บไซต์ ทำให้สามารถใช้งานได้ทุกอุปกรณ์ ที่ไหนก็ได้ โดยไม่ต้องดาวน์โหลดแอปเพิ่ม
  • Self-Hosted - รองรับการ selfhost ให้เราเก็บข้อมูลสำคัญไว้กับเราเอง
  • Real-time collaboration - สามารถทำงานร่วมกับผู้อื่นได้แบบ realtime ง่ายๆแค่แชร์ลิ้งค์
  • Presentation mode - มีโหมดสำหรับการนำเสนอที่อ่านง่าย สบายตา เรียบร้อย
  • Graphs & diagrams - รองรับ graphs และ diagram ในตัวหลายรูปแบบ
  • Permission system - มีระบบการจำกัดสิทธ์สำหรับ note ของคุณมั่นใจได้ว่าจะไม่มีใครมาแก้ note คุณโดยไม่ได้รับอนุญาติ
  • Revisions - สามารถย้อนกลับเพื่อแก้ไขสิ่งที่ผิดพลาดได้ (ctrl + z)
  • Low system requirement - ใช้ทรัพยากรเครื่องต่ำ ใช้งานได้ลื่นไหลในทุกอุปกรณ์

ทดลองใช้งาน

มีระบบ login

มีระบบ login ให้แต่ละ user มี note ของตัวเองไม่ตีกับของคนอื่น และ คนอื่นก็มายุ่งกับ note ของเราไม่ได้

user note

มีหน้าสำหรับจัดการ note ของ user นั้นๆโดยสามารถ สร้าง , ลบ , ค้นหา ได้จากตรงนี้เลย

หน้าสำหรับการเขียน note โดยจะแบ่งออกมาเป็น 2 ฝั่งโดยเราจะเขียนที่ฝั่งซ้ายและมี preview แบบ realtime ที่ฝั่งขวา โดยมี auto complete ช่วยให้เราเขียนได้ง่ายขึ้น และมี tool ช่วยสำหรับคนที่ยังไม่ถนัด markdown

publish

หน้า publish สำหรับส่งให้คนอื่นไปอ่านหรือไม่ต้องการให้คนมาแก้ไข โดยจะแปลง markdown ที่เราเขียนออกมาเป็นรูปแบบที่เรียบง่าย สวยงาม สบายตา โดยสามารถ copy link ส่งให้กันได้เลยย

collaboration

เมื่อทำงานร่วมกับคนอื่นก็จะมี สี cursor ของคนที่เข้ามา join ด้วยต่างออกไปทำให้ทำงานร่วมกันได้ ไม่ตีกัน

ข้อดี / ข้อเสีย / เหมาะกับใคร

ข้อดี - UI สวย ใช้งานง่าย ,ใช้ markdown , ลื่นมาก
ข้อเสีย - การ collaboration อาจยังมีบัคอยู่บ้างบางครั้ง , ถ้าเปลี่ยน font ได้จะดีมาก
เหมาะกับ - นักเรียน , developer ที่อยากจะมี note ไว้เก็บข้อมูลต่างๆ

การติดตั้ง

ในการติดตั้ง HedgeDoc แนะนำให้ติดตั้งด้วย docker โดยสามารถทำตาม official doc หรือทำตามใน blog นี้ก็ได้เช่นกัน ด้วย docker-compose นี้

version: '3'
services:
  database:
    image: postgres:13.4-alpine
    environment:
      - POSTGRES_USER=hedgedoc
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=hedgedoc
    volumes:
      - database:/var/lib/postgresql/data
    restart: always
  app:
    # Make sure to use the latest release from https://hedgedoc.org/latest-release
    image: quay.io/hedgedoc/hedgedoc:1.9.6
    environment:
      - CMD_DB_URL=postgres://hedgedoc:password@database:5432/hedgedoc
      - CMD_DOMAIN=localhost
      - CMD_URL_ADDPORT=true
    volumes:
      - uploads:/hedgedoc/public/uploads
    ports:
      - "3000:3000"
    restart: always
    depends_on:
      - database
volumes:
  database:
  uploads:
docker-compose.yml
⚠️
อย่าลืมแก้ password ด้วย

หลังจากติดตั้งเสร็จก็สามารถเข้าผ่าน http://<ip เครื่อง>:3000 ได้เลย

ℹ️
สำหรับคนที่ทำ reverse proxy ให้เปิด socket ด้วย

ขอขอบคุณทุกคนที่อ่านจนจบ หากมีข้อผิดพลาดหรือเนื้อหายังไม่สมบูรณ์ยังไงก็ขออภัยไว้ ณ ที่นี้ด้วย หรือหากใครที่มีคำแนะนำผมก็ยินดีที่จะปรับปรุง สุดท้ายก็หวังว่าทุกคนจะสนุกและ enjoy ไปกับโลกของการ selfhost นะครับ😄