# rawdoc

> 마크다운 편집기 rawdoc의 명령줄 도구(CLI)입니다

Latest version **0.1.0** (published 2026-09-23) · UNLICENSED license · 0 weekly downloads

## Install

```sh
npm install rawdoc
pnpm add rawdoc
yarn add rawdoc
bun add rawdoc
```

Provides the command `rawdoc`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.1.0 |
| Published | 2026-09-23 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | UNLICENSED |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 0 |
| Unpacked size | 44.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | r00neyj |

## Links

- npm: https://www.npmjs.com/package/rawdoc
- Repository: https://github.com/R00neyj/rawdoc
- Homepage: https://github.com/R00neyj/rawdoc#readme
- Issues: https://github.com/R00neyj/rawdoc/issues
- npm.io page: https://npm.io/package/rawdoc

## Recent versions

- 0.1.0 (latest) — 2026-09-23

## README

# rawdoc CLI

[rawdoc](https://rawdoc.app/) 문서를 터미널·스크립트·AI 도구에서 읽고 고치는 명령줄 도구입니다.

## 설치 없이 쓰기

```
npx -y rawdoc ls
```

`-y` 는 처음 실행할 때 나오는 설치 확인을 건너뜁니다. AI 도구(Claude Code 등)에서 비대화형으로 부를 때는 이 형태를 씁니다.

## 전역 설치

```
npm i -g rawdoc
rawdoc ls
```

## 로그인

```
rawdoc login
```

브라우저가 열리고 rawdoc 계정으로 승인하면 토큰이 이 컴퓨터에 저장됩니다(`%APPDATA%\md-editor\credentials.json` 또는 `~/.config/md-editor/credentials.json`).

원격 셸(SSH·컨테이너)처럼 브라우저가 이 기계의 `127.0.0.1` 에 닿지 않는 환경에서는 웹의 계정 메뉴 → API 토큰에서 만든 토큰을 표준 입력으로 넘깁니다:

```
rawdoc login --with-token < token.txt
```

## 환경 변수

| 이름 | 뜻 |
| --- | --- |
| `RAWDOC_TOKEN` | 저장된 토큰 대신 쓸 API 토큰. CI·AI 도구용이며 저장하지 않습니다 |
| `RAWDOC_SERVER` | 기본 서버(`https://rawdoc.app`) 대신 쓸 주소. `http://localhost:8790` 처럼 로컬 서버만 `http` 를 허용합니다 |

## 명령

| 명령 | 하는 일 |
| --- | --- |
| `login` | 브라우저로 로그인해 토큰을 저장합니다 |
| `logout` | 이 컴퓨터에 저장한 토큰을 지웁니다(서버 토큰은 남습니다) |
| `whoami` | 로그인한 계정을 보여 줍니다 |
| `ls [--folder <id>]` | 내 문서 목록 |
| `get <id> [-o <파일>]` | 문서 원문을 출력하거나 파일로 받습니다 |
| `new [<파일>\|-] [--title <제목>] [--folder <id>]` | 새 문서를 만듭니다 |
| `put <id> [<파일>\|-] [--title <제목>] (--base-version <n>\|--force)` | 문서를 고칩니다 |
| `folders` | 폴더 목록 |
| `mkdir <이름> [--parent <id>]` | 폴더를 만듭니다 |
| `upload <이미지파일>` | 이미지를 올리고 붙일 마크다운을 출력합니다 |
| `link <id>` | 읽기 전용 링크를 만듭니다 |

모든 명령은 `--server <주소>`, `--json`, `-h/--help` 를 받습니다.

## 종료 코드

| 종료 | 뜻 |
| --- | --- |
| 0 | 성공 |
| 1 | 연결·시간 제한·서버·파일 오류 |
| 2 | 인자 사용법 오류 |
| 3 | 로그인 필요·토큰 무효 |
| 4 | 권한 없음·찾을 수 없음 |
| 5 | 문서가 그 사이 바뀜(충돌) |
| 6 | 브라우저에서 편집 중이라 잠김 |
| 7 | 용량 초과 |
| 130 | Ctrl+C |

## 원문 보존

`put`·`new` 에 올린 파일은 앱의 가져오기와 같은 해독을 거칩니다 — 섞인 줄바꿈은 CRLF 로 통일되고 BOM 은 제거됩니다(그때 표준 오류에 안내가 뜹니다). `get` 은 문서 원문을 한 글자도 바꾸지 않고 그대로 표준 출력에 씁니다.

**Windows PowerShell 5.1** 에서 `>` 로 표준 출력을 파일에 받으면 UTF-16 으로 바뀌고 한글이 깨집니다. `get -o 파일.md` 를 쓰세요.

## 토큰 폐기

`logout` 은 이 컴퓨터에 저장한 토큰만 지웁니다. 서버에 남은 토큰을 폐기하려면 웹의 계정 메뉴 → API 토큰에서 폐기하세요.

---
_Source: https://npm.io/package/rawdoc · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._