Hacker News 의견
  • Markdown의 가장 큰 장점은 읽기 쉽고 쓰기 쉬운 점임
  • Markdown은 책을 쓰기 위한 최적의 도구는 아닐 수 있지만, 빠르게 형식화된 텍스트를 작성하는 데 최적임
  • LaTeX를 사용하여 책을 쓸 것이며, Markdown은 메모 작성, 빠른 문서화 및 댓글 작성에 적합함
  • reStructuredText(reST)는 자체로는 다소 거칠지만, Sphinx와 결합하면 매우 훌륭함
    • Sphinx는 대규모, 전문적인 문서 사이트에 적합한 선택임
    • Sphinx는 사이트의 공통 요소를 쉽게 커스터마이징할 수 있게 함
    • 내부 링크가 항상 해결되도록 보장함
    • 확장 및 테마 API가 잘 정의되어 있음
    • PyPI에 다양한 확장 및 테마가 존재함
  • Markdown은 HTML의 경량 표현이며, reST는 추상 문서 트리의 중간 무게 표현임
  • Markdown은 이메일 메시지와 Usenet 게시물의 형식화 텍스트를 변환하기 위해 설계됨
  • reST 도구는 RST 파일을 자동으로 생성하는 기능이 부족함
  • Markdown은 간단한 작업을 빠르게 수행할 수 있게 해주며, 필요 시 원시 HTML을 삽입할 수 있음
  • MyST는 reStructuredText의 기능을 제공하면서 Markdown 구문을 사용할 수 있게 함
  • GitHub 프로젝트 페이지의 문서화는 복잡할 수 있으며, Sphinx와 Markdown을 함께 사용하는 것이 유용할 수 있음
  • 저자는 자신의 책을 조판하는 맥락에서 rST를 언급하고 있음
  • reST는 MarkDown의 경쟁자가 아니라, MarkDown보다 먼저 등장한 형식임
  • Markdown과 reST는 기본적으로 동일한 목표를 가지고 있음
  • Markdown과 reST는 둘 다 읽기 쉽고 빠르게 작성할 수 있음
  • Markdown은 역사적 이유로 더 널리 사용되게 되었음
  • Markdown은 커스텀 블록 타입을 정의하고 문서 트리를 변환할 수 있음
  • Jupyter Book은 Markdown을 사용하여 PDF와 같은 다른 타겟으로 렌더링할 수 있는 좋은 예임