diff --git a/docs/macedonian/README.md b/docs/macedonian/README.md
new file mode 100644
index 0000000000..341f27e76f
--- /dev/null
+++ b/docs/macedonian/README.md
@@ -0,0 +1,49 @@
+
+
+# Референци
+
+Здраво 👋!
+
+Овој директориум ја содржи целата документација за контирутирање на freeCodeCamp.org
+
+## [Доколку сте почетник, започнете прво со читање на следново.](/CONTRIBUTING.md)
+
+---
+
+## Референци за артикли
+
+1. Како да работите на водичи .
+2. Како да работите на предизвици за кодирање.
+3. Како да го поставите freeCodeCamp локално.
+4. Како да фаќате излезни е-маилови локално.
+
+## Стилски водич
+
+1. Стилски водич за креирање артикли.
+2. Стилски водич за креирање предизвици со кодирање.
+
+## Брзи упатства за команди кога работите локално
+
+Брзи референци за командите што ќе ви требаат, кога ќе работите локално.
+
+| команда | опис |
+| ------- | ----------- |
+| `npm run bootstrap` | Bootstrap на различни сервиси |
+| `npm run seed` | Анализирај ги сите markdown фајлови за предизвиците и вметни ги во MongoDB. |
+| `npm run develop` | Го стартува API-серверот на FreeCodeCamp и клиентските апликации |
+| `npm test` | Стартувај ги сите JS тестови во системот, вклучувајќи ги клиентските, серверите, линтинг и тестовите од придизвици |
+| `npm run test:client` | Стартувај пакет за тестирање на клиент |
+| `npm run test:curriculum` | Стартувај го тестот за наставна програма |
+| `npm run test:server` | Стартувај пакет за тестирање на серверот |
+| `npm run commit` | Интерактивна алатка за да ви помогне да изградите добра порака за комитирање |