마크다운 위키 조사

Markdown Wiki

• Notion
• Raneto
• MDWiki
• MKDocs

---

Notion

https://www.notion.so

기능

• Windows, macOS, mobile 앱 및 웹
• 무료는 용량 제한
  • 용량제한을 풀기 위해서는 유료 요금제 가입
• 에디터 및 저장소 역할
• 클라우드 기반
• 협업 기능
• Markdown 문법으로 작성
• 파일 첨부 가능
• Markdown 및 PDF 로 내보내기

---

Raneto

http://docs.raneto.com

• 웹서버 (Node.js)
  • 자체적인 서버를 사용하기에 별도의 기능은 커스터마이징 필요
• Markdown 파일들을 웹페이지로 자동 렌더링
  • 별도의 컴파일 없이 markdown 파일을 특정 폴더에 복사
• 폴더 구조를 메뉴 트리 구조로 자동 변환
• Search 지원
• 간단한 설치
• 로그인은 존재하나 관리자 역할만 존재
  • 구글 인증 가능
• 단점
  • 이미지는 특정한 하나의 장소에 위치

# install
$ git clone https://github.com/gilbitron/Raneto.git && cd Raneto && npm install && npm run gulp && npm start$ 
# run
$ npm run start_win
# http://localhost:3000

admin/password

---

MDWiki

http://dynalon.github.io/mdwiki/#!index.md

• 기존에 운용중인 웹서버를 사용

• 설치과정 없이 다운받은 엔진 파일들을 기존의 웹사이트의 임의에 폴더에 복사

• 위키엔진을 통하여 마크다운 파일들을 정적 컨텐츠로 변환

• 다양한 테마

• 별도의 네비게이션 추가 옵션

• 단점:

  • 경로에 #! 가 추가

  http://www.example.com/mdwiki.html#!myfile.md

• 메뉴는 별도로 수동으로 파일에 기술

# 시작
SET DEBUG=my-app:* & npm start

---

MKDocs

https://www.mkdocs.org/

• 기존의 웹서버를 활용
• 파이썬 빌드를 통하여 마크다운 파일들을 압축된 정적 컨텐츠로 변환
• 다양한 테마
• 별도의 네비게이션 옵션

시작

mkdocs serve