diff --git a/docs/docs/01-why-react.ko-KR.md b/docs/docs/01-why-react.ko-KR.md
index 93b41993fb497..8cd1b839a769c 100644
--- a/docs/docs/01-why-react.ko-KR.md
+++ b/docs/docs/01-why-react.ko-KR.md
@@ -27,4 +27,4 @@ React는 많은 관습적인 사고에 도전하며, 첫눈에 볼 때는 이상
## 더 알아보기
-[이 블로그 포스트](/react/blog/2013/06/05/why-react.html)에서 React를 만든 우리의 동기에 대해 알아볼 수 있습니다.
+[이 블로그 포스트](/docs/docs/why-react.md)에서 React를 만든 우리의 동기에 대해 알아볼 수 있습니다.
diff --git a/docs/docs/02-displaying-data.ko-KR.md b/docs/docs/02-displaying-data.ko-KR.md
index df801d1556c8d..8423a0f3fa88e 100644
--- a/docs/docs/02-displaying-data.ko-KR.md
+++ b/docs/docs/02-displaying-data.ko-KR.md
@@ -89,9 +89,9 @@ JSX를 이용하면:
우리는 이것이 React 앱들을 만들기 쉽게 하고, 디자이너들이 이 문법을 더 선호하는 것을 발견했습니다, 하지만 모든 사람은 그들만의 선호하는 워크플로우가 있기 마련이므로, **JSX는 React를 사용하기 위해 필수적이지는 않습니다.**
-JSX는 매우 작은 언어입니다. 그것을 배우고 싶다면, [JSX 깊게 살펴보기](/react/docs/jsx-in-depth-ko-KR.html)를 살펴 보시기 바랍니다. 또는, [바벨 REPL](https://babeljs.io/repl/)를 통해 문법이 변환되는 것을 살펴 보시기 바랍니다.
+JSX는 매우 작은 언어입니다. 그것을 배우고 싶다면, [JSX 깊게 살펴보기](/docs/docs/02.1-jsx-in-depth.ko-KR.md)를 살펴 보시기 바랍니다. 또는, [바벨 REPL](https://babeljs.io/repl/)를 통해 문법이 변환되는 것을 살펴 보시기 바랍니다.
-JSX는 HTML과 비슷하지만, 완전히 똑같지는 않습니다. [JSX의 실수하기 쉬운 부분들](/react/docs/jsx-gotchas-ko-KR.html)에 중요한 차이점들에 대해 설명되어 있습니다.
+JSX는 HTML과 비슷하지만, 완전히 똑같지는 않습니다. [JSX의 실수하기 쉬운 부분들](/docs/docs/02.3-jsx-gotchas.ko-KR.md)에 중요한 차이점들에 대해 설명되어 있습니다.
[바벨에서 JSX를 시작하는 여러 방법을 제공합니다](http://babeljs.io/docs/setup/). 여기에는 커맨드 라인 툴부터 루비 온 레일스 연동까지 다양한 방법이 있습니다. 가장 편한 툴을 사용하세요.
diff --git a/docs/docs/02.1-jsx-in-depth.ko-KR.md b/docs/docs/02.1-jsx-in-depth.ko-KR.md
index 92525f8643c49..6fea6225a8d59 100644
--- a/docs/docs/02.1-jsx-in-depth.ko-KR.md
+++ b/docs/docs/02.1-jsx-in-depth.ko-KR.md
@@ -74,7 +74,7 @@ var app = React.createElement(
);
```
-클래스에 [displayName](/react/docs/component-specs-ko-KR.html#displayName)이 정의되어 있지 않으면 JSX는 변수명을 displayName으로 간주할 것입니다:
+클래스에 [displayName](/docs/docs/ref-03-component-specs.ko-KR.md#displayName)이 정의되어 있지 않으면 JSX는 변수명을 displayName으로 간주할 것입니다:
```javascript
// 입력 (JSX):
@@ -83,9 +83,9 @@ var Nav = React.createClass({ });
var Nav = React.createClass({displayName: "Nav", });
```
-[바벨 REPL](https://babeljs.io/repl/)를 보면 JSX에서 어떻게 네이티브 JavaScript로 변환(desugars)하는지 볼 수 있고, [HTML-JSX 변환기](/react/html-jsx.html)는 이미 있는 HTML을 JSX로 변환해 줍니다.
+[바벨 REPL](https://babeljs.io/repl/)를 보면 JSX에서 어떻게 네이티브 JavaScript로 변환(desugars)하는지 볼 수 있고, [HTML-JSX 변환기](/docs/html-jsx.md)는 이미 있는 HTML을 JSX로 변환해 줍니다.
-JSX를 사용 하시려면, [시작하기](/react/docs/getting-started-ko-KR.html) 가이드에서 어떻게 컴파일을 하기 위해 설정하는지 보실 수 있습니다.
+JSX를 사용 하시려면, [시작하기](/docs/docs/getting-started.ko-KR.md) 가이드에서 어떻게 컴파일을 하기 위해 설정하는지 보실 수 있습니다.
> 주의:
>
@@ -221,4 +221,4 @@ var content = (
> 주의:
>
-> JSX 는 HTML과 비슷하지만 완전히 같지는 않습니다. 중요한 차이점을 보시려면 [JSX gotchas](/react/docs/jsx-gotchas-ko-KR.html)를 보세요.
+> JSX 는 HTML과 비슷하지만 완전히 같지는 않습니다. 중요한 차이점을 보시려면 [JSX gotchas](/docs/docs/02.3-jsx-gotchas.ko-KR.md)를 보세요.
diff --git a/docs/docs/02.3-jsx-gotchas.ko-KR.md b/docs/docs/02.3-jsx-gotchas.ko-KR.md
index 3dd72770e8702..a7ca3c48c7ed4 100644
--- a/docs/docs/02.3-jsx-gotchas.ko-KR.md
+++ b/docs/docs/02.3-jsx-gotchas.ko-KR.md
@@ -1,16 +1,16 @@
---
id: jsx-gotchas-ko-KR
title: JSX Gotchas
-permalink: jsx-gotchas-ko-KR.html
-prev: jsx-spread-ko-KR.html
-next: interactivity-and-dynamic-uis-ko-KR.html
+permalink: jsx-gotchas-ko-KR.md
+prev: jsx-spread-ko-KR.md
+next: interactivity-and-dynamic-uis-ko-KR.md
---
JSX는 HTML처럼 보이지만, 작업하다 보면 마주치게 될 몇 가지 중요한 차이점이 있습니다.
> 주의:
>
-> 인라인 `style` 어트리뷰트 같은 DOM과의 차이점은 [여기](/react/tips/dangerously-set-inner-html-ko-KR.html)를 보세요.
+> 인라인 `style` 어트리뷰트 같은 DOM과의 차이점은 [여기](/docs/tips/dangerously-set-inner-html-ko-KR.md)를 보세요.
## HTML 엔티티
@@ -46,7 +46,7 @@ JSX의 리터럴 텍스트에 HTML 엔티티를 넣을 수 있습니다.
{['First ', ·, ' Second']}
```
-최후의 수단으로, 항상 [생 HTML을 삽입](/react/docs/dom-differences-ko-KR.html)할 수 있습니다.
+최후의 수단으로, 항상 [생 HTML을 삽입](/docs/docs/ref-06-dom-differences.ko-KR.md)할 수 있습니다.
```javascript
diff --git a/docs/docs/03-interactivity-and-dynamic-uis.ko-KR.md b/docs/docs/03-interactivity-and-dynamic-uis.ko-KR.md
index ef3b3526c6ce7..c3c0902a614cd 100644
--- a/docs/docs/03-interactivity-and-dynamic-uis.ko-KR.md
+++ b/docs/docs/03-interactivity-and-dynamic-uis.ko-KR.md
@@ -6,7 +6,7 @@ prev: jsx-gotchas-ko-KR.html
next: multiple-components-ko-KR.html
---
-이미 React에서 [어떻게 데이터를 표시](/react/docs/displaying-data-ko-KR.html)하는지를 배웠습니다. 이제 UI와의 상호작용을 어떻게 만드는지 살펴보죠.
+이미 React에서 [어떻게 데이터를 표시](/docs/docs/02-displaying-data-ko-KR.md)하는지를 배웠습니다. 이제 UI와의 상호작용을 어떻게 만드는지 살펴보죠.
## 간단한 예제
diff --git a/docs/docs/04-multiple-components.ko-KR.md b/docs/docs/04-multiple-components.ko-KR.md
index ec8d8c751d442..ade9da74d920a 100644
--- a/docs/docs/04-multiple-components.ko-KR.md
+++ b/docs/docs/04-multiple-components.ko-KR.md
@@ -66,7 +66,7 @@ React 컴포넌트 인스턴스를 만들 때, 추가적인 React 컴포넌트
```
-`Parent`는 `this.props.children`라는 특수 prop으로 자식들을 읽을 수 있습니다. **`this.props.children` 는 불투명한 데이터 구조이며,** [React.Children 유틸리티](/react/docs/top-level-api-ko-KR.html#react.children)를 사용해 자식들을 관리합니다.
+`Parent`는 `this.props.children`라는 특수 prop으로 자식들을 읽을 수 있습니다. **`this.props.children` 는 불투명한 데이터 구조이며,** [React.Children 유틸리티](/docs/docs/ref-01-top-level-api.ko-KR.md#react.children)를 사용해 자식들을 관리합니다.
### 자식 Reconciliation (비교조정)
@@ -176,7 +176,7 @@ React에서 데이터는 위에서 말한 것처럼 `props`를 통해 소유자
소유자가 가지고 있는 노드의 수가 많아지면 데이터가 변화하는 비용이 증가할 것으로 생각할 수도 있습니다. 좋은 소식은 JavaScript의 속도는 빠르고 `render()` 메소드는 꽤 간단한 경향이 있어, 대부분 애플리케이션에서 매우 빠르다는 점입니다. 덧붙여, 대부분의 병목 현상은 JS 실행이 아닌 DOM 변경에서 일어나고, React는 배치와 탐지 변경을 이용해 최적화해 줍니다.
-하지만, 가끔 성능을 위해 정교하게 제어해야 할 때도 있습니다. 이런 경우, React가 서브트리의 처리를 건너 뛰도록 간단히 `shouldComponentUpdate()`를 오버라이드해 false를 리턴하게 할 수 있습니다. 좀 더 자세한 정보는 [React 참조 문서](/react/docs/component-specs-ko-KR.html)를 보세요.
+하지만, 가끔 성능을 위해 정교하게 제어해야 할 때도 있습니다. 이런 경우, React가 서브트리의 처리를 건너 뛰도록 간단히 `shouldComponentUpdate()`를 오버라이드해 false를 리턴하게 할 수 있습니다. 좀 더 자세한 정보는 [React 참조 문서](/docs/docs/ref-03-component-specs.ko-KR.md)를 보세요.
> 주의:
>
diff --git a/docs/docs/05-reusable-components.ko-KR.md b/docs/docs/05-reusable-components.ko-KR.md
index c89e74980be66..0ee91af2e9fc0 100644
--- a/docs/docs/05-reusable-components.ko-KR.md
+++ b/docs/docs/05-reusable-components.ko-KR.md
@@ -139,7 +139,7 @@ var MyComponent = React.createClass({
컴포넌트는 React에서 코드를 재사용할 수 있는 최고의 방법이지만, 가끔 아주 다른 컴포넌트에서 공통 기능이 필요한 때도 있습니다. 이런 상황을 [공통된 관심사(cross-cutting concerns)](https://en.wikipedia.org/wiki/Cross-cutting_concern)라 부르며, React에서는 `mixins`으로 이 문제를 해결합니다.
-예를 들어, 컴포넌트가 주기적으로 업데이트되길 원할 경우가 있습니다. `setInterval()`을 사용하면 쉽지만, 필요 없어지면 메모리를 아끼기 위해 주기를 꼭 취소해야 합니다. React는 컴포넌트가 막 생성거나 없어질 때를 [생명주기 메소드](/react/docs/working-with-the-browser-ko-KR.html#component-lifecycle)를 통해 알려줍니다. 이런 메소드들을 사용해서 컴포넌트가 사라질 때 자동으로 정리해주는 `setInterval()`를 제공해주는 간단한 믹스인을 만들어보겠습니다.
+예를 들어, 컴포넌트가 주기적으로 업데이트되길 원할 경우가 있습니다. `setInterval()`을 사용하면 쉽지만, 필요 없어지면 메모리를 아끼기 위해 주기를 꼭 취소해야 합니다. React는 컴포넌트가 막 생성거나 없어질 때를 [생명주기 메소드](/docs/docs/08-working-with-the-browser.ko-KR.md#component-lifecycle)를 통해 알려줍니다. 이런 메소드들을 사용해서 컴포넌트가 사라질 때 자동으로 정리해주는 `setInterval()`를 제공해주는 간단한 믹스인을 만들어보겠습니다.
```javascript
var SetIntervalMixin = {
diff --git a/docs/docs/06-transferring-props.ko-KR.md b/docs/docs/06-transferring-props.ko-KR.md
index 1f4b294831512..35ddadfef3878 100644
--- a/docs/docs/06-transferring-props.ko-KR.md
+++ b/docs/docs/06-transferring-props.ko-KR.md
@@ -8,7 +8,7 @@ next: forms-ko-KR.html
React에서는 컴포넌트를 감싸서 추상화하는 것이 일반적인 패턴입니다. 외부 컴포넌트에서는 간단한 프로퍼티만을 노출하여 복잡한 세부 구현을 감출 수 있습니다.
-[JSX 스프레드 어트리뷰트](/react/docs/jsx-spread-ko-KR.html)를 통해 props에 추가적인 값을 병합할 수 있습니다.
+[JSX 스프레드 어트리뷰트](/docs/docs/02.2-jsx-spread.ko-KR.md)를 통해 props에 추가적인 값을 병합할 수 있습니다.
```javascript
@@ -49,7 +49,7 @@ ReactDOM.render(
> 주의:
>
-> `...` 구문은 객체 잔여 스프레드 제안의 일부입니다. 이 제안은 표준화 과정에 있습니다. 더 자세한 내용은 밑의 [잔여 프로퍼티와 스프레드 프로퍼티 ...](/react/docs/transferring-props.html#rest-and-spread-properties-...) 부분을 참고하세요.
+> `...` 구문은 객체 잔여 스프레드 제안의 일부입니다. 이 제안은 표준화 과정에 있습니다. 더 자세한 내용은 밑의 [잔여 프로퍼티와 스프레드 프로퍼티 ...](/docs/docs/06-transferring-props.ko-KR.md#rest-and-spread-properties-...) 부분을 참고하세요.
때로는 모든 프로퍼티를 일일이 전달 하는것은 지루하고 덧없는 작업입니다. 이 경우 [구조 해체 할당(destructuring assignment)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment)을 다른 프로퍼티를 함께 사용해 미상의 프로퍼티를 추출할 수 있습니다.
diff --git a/docs/docs/07-forms.ko-KR.md b/docs/docs/07-forms.ko-KR.md
index a40583a6c334f..290bea608ddbf 100644
--- a/docs/docs/07-forms.ko-KR.md
+++ b/docs/docs/07-forms.ko-KR.md
@@ -8,7 +8,7 @@ next: working-with-the-browser-ko-KR.html
``, `