이 문서는 マークダウン形式のファイルをPDFファイルに変換する（mermaid・emoji・toc対応）의 번역입니다.

개요

Markdown 형식 파일을 PDF 파일로 변환하라는 요구를 충족시키기 위해 간단한 문서 관리 도구를 만들었습니다.

bmf-san/docs-md-to-pdf-example

별로 생각하지도 않고, 존재하는 것들의 라이브러리를 이용해서 만들었기 때문에 지속 가능성이 별로 느껴지지 않는 구조입니다.

동기 부여

Markdown 형식 파일을 PDF 파일로 변환하려는 경우 md-to-pdf 라이브러리를 사용할 수 있습니다.

이 도서관은 제 이력서를 관리해 준 덕분이기도 합니다.
참조 Manage resumes on Github

인어 표기를 지원하고 유니코드로 등록된 픽토그램 이외의 픽토그램을 사용하고 싶은 욕구가 있어서 그에 해당하는 도형을 만들고자 했습니다.

vscode 확장자vscode-markdown-pdf를 사용하면 쉽게 해결할 수 있지만 vscode가 필요하기 때문에 사람들은 그에 따라 vscode를 설치해야 합니다.

변환에만 vscode를 사용하는 것은 말도 안된다고 생각하여 구현했습니다.

설계

md-to-pdf 라이브러리는 사용하기 쉽고 훌륭하지만 현재 다음 기능은 표준으로 지원되지 않습니다.

인어 표기

이모티콘(유니코드로 등록된 것 제외)

TOC 생성

md-to-pdf은 markedjs/marked의 설정을 확장할 수 있으므로, md-to-pdf을 커스터마이징하면 모두 구현할 수 있을 것 같습니다.

TOC가 지원될 예정인 것 같습니다.
Generate TOC (table of contents) #74

md-to-pdf 을 사용할 수도 있었지만 시간이 조금 걸릴 것 같아서 해커톤처럼 최대한 빨리 구현했습니다. 싶어서 md-to-pdf-ng 이라는 라이브러리를 사용하기로 했습니다.

인어 표기법을 지원하도록 확장된 라이브러리md-to-pdf입니다. 문제없이 사용할 수 있습니다.

md-to-pdf-ng 을 기반으로 이모티콘 지원은 node-emojify 이며, TOC 생성은 doctoc 이라는 라이브러리를 사용하여 구현됩니다.

구현

npm으로 다음을 설치합니다.

md-to-pdf-ng

node-emojify

doctoc

*Textlint는 엑스트라로 추가되는데 그 부분은 생략합니다.

Emoji 지원은 Marked를 확장하여 지원하므로 다음 구성 파일을 준비하십시오.

const marked = require('marked');
const { emojiify } = require('node-emoji');

const renderer = new marked.Renderer();

renderer.text = emojiify;

module. exports = {
marked_options: { renderer },
};

package.json의 스크립트에서 다음 명령을 정의합니다.

doctoc --notitle md/ && md-to-pdf md/*.md --config-file config.js && mv md/*.pdf pdf/

먼저 doctoc으로 TOC를 생성한 다음 markdown을 PDF로 변환하고 마지막으로 디렉토리를 이동합니다.

md-to-pdf로 생성된 pdf의 출력처를 디렉토리 단위로 지정할 수 있으면 좋겠지만 그런 옵션이 없는 것 같아서 mv md/*.pdf pdf/라는 쉬운 방법으로 처리한다.

인상

이런 것을 만들려고 하면 외부 라이브러리에 의존하는 경향이 있습니다.
가능하다면 모든 것을 직접 구현하고 싶지만 상당히 어려운 것 같습니다.
기회가 된다면 PDF의 데이터 구조를 배우고 Go에서 유사한 CLI 도구를 만들고 싶습니다.