← 블로그

GitHub의 PCB 파일을 브라우저에서 열기 — README 배지까지

A KiCad board opened from a GitHub link in the MakerSuite 3D viewer

GitHub에 있는 보드를 한 번에

GitHub는 .kicad_pcb나 .PcbDoc를 긴 텍스트나 "바이너리 파일" 안내로만 보여 줍니다. 보드를 실제로 보려면 저장소를 받아 CAD 툴로 열어야 했습니다. 이제 파일의 GitHub 링크를 MakerSuite 3D에 붙여 넣으면 보드가 3D로 열립니다. 브라우저가 GitHub에서 바로 받아 오므로 파일이 우리 서버를 거치지 않습니다.

GitHub 파일 여는 법

  1. GitHub에서 설계 파일 자체를 연 뒤(주소창에 /blob/이 들어감) 링크를 복사
  2. MakerSuite 3D 홈의 드롭 영역 아래 링크 입력칸에 붙여 넣거나, pcbviewer.app/open?url= 뒤에 링크를 붙여 접속
  3. 보드나 회로도가 뷰어에서 열림. KiCad 계층 회로도는 같은 폴더의 하위 시트를 자동으로 함께 받아 옴
  4. 뷰어에서 공유를 열면 그 파일의 README 배지를 복사할 수 있음

README 배지 만들기

보드나 회로도 파일의 GitHub 링크를 붙여 넣으세요. 마크다운을 README에 넣으면 누구든 배지를 눌러 이 파일을 여기서 3D로 열 수 있고, 늘 그 브랜치의 최신 버전이 열립니다.

Paste a GitHub link and see the board in 3D - nothing to install.

MakerSuite 3D 무료로 써보기

되는 것

  • 포맷 — 뷰어가 여는 모든 보드·회로도·라이브러리 포맷: KiCad, Altium, Eagle, EasyEDA, PADS, P-CAD, Protel 99, Gerber ZIP
  • 링크 — GitHub 파일 페이지(/blob/, /raw/), raw.githubusercontent.com 링크, GitLab 파일 페이지, Git LFS로 저장된 파일
  • 계층 — KiCad 회로도의 하위 시트를 같은 폴더에서 받아 옴
  • 개인정보 — GitHub에서 브라우저로 바로 받으며, 파일은 어디에도 업로드되지 않음

한계

비공개 저장소는 이 방법으로 열 수 없습니다(브라우저가 접근할 수 없음). 파일을 내려받아 끌어다 놓으세요. 중국 본토에서는 GitHub 접속이 자주 막히므로 같은 방법을 쓰세요. GitHub와 GitLab 링크만 엽니다. 다른 곳에 있는 파일은 내려받아 끌어다 놓으세요.

스크린샷 대신 배지인 이유

README의 스크린샷은 보드가 바뀌는 순간 낡습니다. 배지는 브랜치의 파일 자체를 가리키므로 누를 때마다 현재 배치가 보이고, 넷 하이라이트·측정·BOM·DFM 검사도 바로 이어서 쓸 수 있습니다.

읽는 사람에게는 "저장소 받기, KiCad 설치, 열기"라는 단계를 없애 줍니다. 대부분의 사람이 하드웨어 저장소의 보드를 끝내 열어 보지 않는 이유가 그 단계입니다.

자주 묻는 질문

Is the file uploaded to MakerSuite 3D?

No. Your browser downloads the file directly from GitHub (raw.githubusercontent.com allows this) and parses it locally. Nothing is sent to our server.

Which links work?

A GitHub file page (the address contains /blob/ or /raw/), a raw.githubusercontent.com link, or a GitLab file page. A repository or folder link does not work - open the file first and copy its address.

Does the badge always show the latest version?

Yes, if the link points at a branch such as main: each click downloads the file as it is on that branch. Link to a tag or commit to pin a version.

Can I open a private repository?

No. The browser has no access to private files. Download the file and drop it onto the page instead.

관련 글

How to View KiCad .kicad_pcb Files in 3D OnlineFree Online Altium Library Viewer — Open .PcbLib & .SchLib FilesShare PCB Design Review Notes — Annotation Links in Your Browser

지금 GitHub 링크를 붙여 보드를 열어 보세요 — 무료.

MakerSuite 3D 열기