마크다운


마크다운은 텍스트 에디터에서 간단하게 문서를 작성할 수 있는 양식입니다.

변환기


마크다운 문법을 HTML로 출력하기 위해서는 변환기가 필요로 합니다. 지니PHP는 마크다운 웹 변환을 하기 위해서 외부 페키지를 같이 이용합니다.

이 페키지의 기본 원형은 erusev/parsedown 입니다.

편집기


개발자들에게는 마크다운 문서작성법은 매우 익숙할 것입니다. 마크다운은 글의 내용과 함께 몇가지 기호를 같이 사용하게 됩니다. 이러한 작성방식은 일반 사용자에게는 익숙하지 않습니다.

최근에는 여러 종류의 전용 에디터가 많이 있습니다. 대표적으로는 타이포라라는 무료 에디터가 있습니다. 타이포라는 https://typora.io/ 에서 무료로 다운로드 받을 수 있습니다. 전용 에디터를 이용하면 직관적으로 글을 작성할 수 있습니다.

자동경로 처리


마크다운, html등 문서에 이미지를 넣을 수 있습니다.

문서에 이미지를 삽입하기 위해서는 경로를 같이 설정해야 합니다. 가장 쉽게 이미지를 삽입하는 방법은 상대경로를 사용하는 것입니다. 상대경로로 문서를 작성해 두면, 문서편집기에서도 쉽게 이미지를 같이 확인을 할 수 있습니다.

하지만, 이렇게 설정된 상대경로가 프레임워크에서 동작을 할때에는 문제가 발생합니다. 프레임워크에서 외부로 보이는 경로는 /public 부터 입니다. 또한 마크다운로 작성된 리소스는 /resource 로 외부와 내부의 경로가 일치 하지 않습니다.

지니PHP에서는 이렇게 차이가 나는 이미지의 경로를 자동으로 매칭하여 동작을 처리해 주게 됩니다.

문서상에서 ./img/파일명 이렇게 내부 경로를 만들어 놓으면 실제 view에서 처리할때 public/_로 이미지를 복사하여 경로를 재설정을 자동으로 처리해 줍니다.