Markdown to HTML Converter | MD2HTML

.md 파일을 A4 규격의 미니멀하고 모던한 디자인 HTML로 변환합니다. 웹에서 바로 미리보기할 수 있습니다.

🚀 빠른 시작

1. 설치

```bash npm install -g @synapworks/md-to-html-converter ```

설치가 완료되면 Claude Desktop 설정 파일이 자동으로 업데이트됩니다!

2. Claude Desktop 재시작

Claude Desktop을 완전히 종료한 후 다시 시작하세요.

3. 사용 시작

Claude Desktop에서 MCP 서버가 자동으로 로드되며, 바로 사용할 수 있습니다.

📋 수동 설정 (선택사항)

자동 설정이 작동하지 않는 경우, Claude Desktop 설정 파일에 다음을 추가하세요:

macOS

```bash nano ~/Library/Application\ Support/Claude/claude_desktop_config.json ```

Windows

``` %APPDATA%\Claude\claude_desktop_config.json ```

Linux

```bash nano ~/.config/Claude/claude_desktop_config.json ```

설정 내용: ```json { "mcpServers": { "md-to-html-converter": { "command": "md-to-html-converter", "env": { "API_URL": "https://api.synapworks.net/api", "API_KEY": "your-api-key-here" } } } } ```

🔧 환경 변수

• API_URL: 백엔드 API URL (기본값: https://api.synapworks.net/api)
• API_KEY: API 인증 키 (선택사항)

환경 변수를 설정하려면 설정 파일의 env 섹션에 추가하세요.

워크플로우 단계

1. Markdown 입력

Markdown 파일 내용을 입력받습니다. 파일 내용을 텍스트로 붙여넣거나 직접 입력할 수 있습니다.

파라미터:

• markdown_content (string, 필수): Markdown 내용
  • Markdown 파일의 전체 내용을 입력하세요. 파일을 읽어서 텍스트로 붙여넣거나 직접 작성할 수 있습니다.

2. HTML 변환

입력된 Markdown을 A4 규격의 미니멀하고 모던한 HTML로 변환합니다.

파라미터:

• markdown_content (string, 필수): Markdown 내용
  • 이전 단계에서 입력받은 Markdown 내용

3. HTML 파일 생성 및 미리보기

변환된 HTML을 파일로 저장하고 웹에서 미리보기할 수 있는 링크를 제공합니다.

파라미터:

• html_content (string, 필수): HTML 내용
  • 이전 단계에서 생성된 HTML 내용
• filename (string, 선택): 파일명
  • 생성할 HTML 파일명 (확장자 제외, 기본값: output)

역할

Markdown을 HTML로 변환하는 전문가

환영 메시지

안녕하세요! Markdown 파일을 A4 규격의 미니멀하고 모던한 HTML로 변환해드립니다. .md 파일 내용을 입력해주세요.

제약사항

Answer in Korean

📦 버전

현재 버전: 1.0.0

🆘 문제 해결

macOS: "앱을 열 수 없습니다" 또는 "신뢰할 수 없는 개발자" 경고

macOS Gatekeeper가 서명되지 않은 앱을 차단할 수 있습니다. 다음 방법으로 해결하세요:

방법 1: 우클릭으로 열기 (권장)

1. 다운로드한 .app 파일을 찾습니다
2. 우클릭 (또는 Control + 클릭)을 합니다
3. **"열기"**를 선택합니다
4. 경고 창에서 **"열기"**를 다시 클릭합니다

방법 2: 시스템 설정에서 허용

1. 시스템 설정 > 보안 및 개인 정보 보호로 이동
2. "확인 없이 열기" 버튼을 클릭
3. 또는 "일반" 탭에서 차단된 앱 옆의 "확인 없이 열기" 클릭

방법 3: 터미널에서 실행 ```bash xattr -cr "상품 상세페이지 제작 챗봇 | PageWizard-GPT Installer.app" open "상품 상세페이지 제작 챗봇 | PageWizard-GPT Installer.app" ```

MCP 서버가 시작되지 않음

• Node.js 버전 확인 (18.0.0 이상 필요)
• 전역 설치 확인: npm list -g @synapworks/md-to-html-converter
• 의존성 재설치: npm install -g @synapworks/md-to-html-converter

Claude Desktop에서 도구가 보이지 않음

• 설정 파일 JSON 문법 확인
• Claude Desktop 완전 재시작 (모든 창 닫기)
• 설정 파일 경로 확인
• Claude Desktop 로그 확인

설정 파일 위치를 모르겠어요

설정 파일은 다음 위치에 있습니다:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

📝 라이선스

MIT

🔗 관련 링크

• Synapworks 웹사이트
• 문의하기