SpecToDocs (API 문서 변환)

SpecToDocs는 API 명세 파일을 깔끔한 마크다운 문서로 바꿔 주는 개발자용 변환 도구입니다. 메이커가 적은 문제 상황이 구체적입니다. Swagger나 Postman으로 테스트를 끝내고 나면 노션 명세서는 아직 비어 있고, 엔드포인트와 파라미터, 요청·응답 예시를 다시 손으로 타이핑하게 됩니다. Swagger 파일 안에는 그 정보가 이미 전부 구조화돼 있는데 왜 사람이 다시 치고 있어야 하는가가 출발점이었습니다.

Swagger/OpenAPI, Postman Collection, Insomnia Export 중 무엇으로 API를 관리하든 파일 하나를 올리면 마크다운으로 자동 변환됩니다. 공개 뒤 실제 피드백을 받아 고친 기록도 함께 적혀 있습니다. 개발자 커뮤니티에 올려 “테스트용 샘플 파일이 있으면 좋겠다”는 의견을 받아 포맷별 예제 파일과 원클릭 체험 버튼을 넣었고, 테스터가 Swagger 공식 데모 파일에서 파싱 에러를 겪자 원인이 구버전 Swagger 2.0 미지원이라는 것을 찾아 고쳤습니다. 메이커가 아직 없는 것도 그대로 적어 뒀습니다. 로그인 기능은 다음 목표이고, Insomnia는 요청 구조는 가져오지만 예시 응답까지는 못 가져옵니다.

1인 SaaS에 모인 개발자 유틸 중에서도 이 도구는 범위가 아주 좁습니다. 101Tool이 API 테스트부터 변환기까지 넓게 펼쳐 놓는 쪽이라면, SpecToDocs는 이미 있는 명세를 읽는 문서로 바꾸는 한 단계만 맡습니다.

이런 분께 맞아요

• Swagger로 테스트하고 노션·위키에 명세를 다시 옮겨 적던 백엔드 개발자
• 협업용 API 문서를 빠르게 만들어야 하는 소규모 팀
• Postman Collection을 문서 형태로 공유하고 싶은 사람