[command-line] GitHub 플레이 버드 마크 다운을 렌더링하기위한 명령 줄 유틸리티가 있습니까?

Program / 글쓴이

GitHub 플레이 버드 마크 다운 파일 을 가져 와서 HTML로 렌더링하기 위한 명령 줄 유틸리티가 있는지 궁금합니다 .

웹 사이트 콘텐츠를 만들기 위해 GitHub 위키를 사용하고 있습니다. 서버에서 리포지토리를 복제 한 다음 일반 HTML로 처리하려고합니다. GitHub에 나타나는 것은 내 웹 사이트를 찾는 방법과 정확히 일치하는 것이 중요합니다. 또한와 함께 분리 된 블록을 사용하고 ~~~싶습니다. 따라서 표준 Markdown 구문 만 사용하고 싶지 않습니다.

Node.js에 연결할 수 있다고 생각하는 JavaScript 라이브 미리보기를 조금 보았지만 더 이상 사용되지 않는다고 말합니다. 레드 카펫 저장소를 살펴 봤지만 명령 행 인터페이스가있는 것처럼 보이지 않습니다.

그러나 내 솔루션을 롤백했지만 여기에 다른 솔루션보다 분명히 좋은 솔루션은 없으므로 선택한 답변없이 질문을 남길 것입니다.

답변

파이썬으로 작은 CLI를 작성하고 GFM 지원을 추가했습니다. 그것은라고 그립 (Github의 추가 정보 인스턴트 미리보기) .

다음과 같이 설치하십시오.

$ pip install grip

그리고 그것을 사용하려면 간단히 :

$ grip

그런 다음 해당 위치에서 파일 localhost:5000을 보려면 방문하십시오 readme.md.

자신의 파일을 지정할 수도 있습니다.

$ grip CHANGES.md

그리고 포트를 변경하십시오 :

$ grip 8080

물론 GitHub-Flavored Markdown을 선택적으로 리포지토리 컨텍스트와 함께 렌더링하십시오.

$ grip --gfm --context=username/repo issue.md

주목할만한 특징 :

  • 페이지를 GitHub에서와 같이 정확하게 렌더링합니다
  • 울타리 블록
  • 파이썬 API
  • 링크 된 파일 사이를 탐색하십시오 (감사합니다, vladwing !)2.0에 추가 된
  • 2.0에 추가 된 단일 파일 (감사, iliggio !)로 내보내기
  • 신규 : 3.0 에서 읽기 stdin및 내보내기stdout

이것이 누군가를 돕기를 바랍니다. 확인하십시오 .

답변

나는 GitHub 맛 Markdown에 대한 빠르고 쉬운 방법을 찾지 못했지만 약간 더 일반적인 버전을 찾았습니다 -Pandoc . Markdown, Rest, HTML 등을 포함하여 여러 형식으로 변환합니다.

또한 Makefile모든 .md 파일을 .html로 변환하기 위해 ( 개발 , 마크 다운 및 Pandoc 의 예제 와 같이 )을 개발했습니다.

# 'Makefile'
MARKDOWN = pandoc --from gfm --to html --standalone
all: $(patsubst %.md,%.html,$(wildcard *.md)) Makefile

clean:
    rm -f $(patsubst %.md,%.html,$(wildcard *.md))
    rm -f *.bak *~

%.html: %.md
    $(MARKDOWN) $< --output $@

답변

아마도 이것이 도움이 될 수 있습니다.

gem install github-markdown

문서가 없지만 골룸 에서 얻었습니다. 문서 . 보면 rubydoc.info 사용할 수있는 것처럼, 그것은 본다 :

require 'github/markdown'
puts GitHub::Markdown.render_gfm('your markdown string')

루비 코드에서. 스크립트로 쉽게 감싸서 명령 줄 유틸리티로 만들 수 있습니다.

#!/usr/bin/env ruby

# render.rb
require 'github/markdown'

puts GitHub::Markdown.render_gfm File.read(ARGV[0])

로 실행하십시오 ./render.rb path/to/my/markdown/file.md. 이것은 소독없이 생산에 사용하기에 안전하지 않습니다.

답변

pip3 install --user markdown
python3 -m markdown readme.md > readme.html

GitHub 확장을 처리하지 않지만 아무것도 아닌 것보다 낫습니다. GitHub 추가를 처리하기 위해 모듈을 확장 할 수 있다고 생각합니다.

답변

아마 당신이 원하는 것은 아니지만 Node.js를 언급 한 이후 : GitHub에 커밋하기 전에 로컬 드라이브에서 GitHub Flavored Markdown 설명서를 미리 볼 수있는 좋은 도구를 찾을 수 없었으므로 오늘 Node.js를 기반으로 문서를 만들었습니다. HTTPS : //github.com/ypocat/gfms

따라서 귀하의 질문이 여전히 실제 인 경우 showdown.js를 위키에 재사용 할 수 있습니다. 그렇지 않다면 아마도 내가했던 것과 같은 문제에 직면 한 다른 사람들 이이 질문과 그 대답을 찾을 수 있습니다.

답변

터미널에서 README.md 파일을 읽으려면 다음을 사용하십시오.

pandoc README.md | lynx -stdin

Pandoc은이를 Lynx가 터미널에서 렌더링하는 HTML 형식으로 출력합니다.

그것은 잘 작동합니다 : 터미널을 채우고 바로 가기가 아래에 표시되어 있으며 스크롤 할 수 있으며 링크가 작동합니다!
글꼴 크기는 하나 뿐이지 만 색상 + 들여 쓰기 + 정렬이 그에 맞게 구성됩니다.

설치:

sudo apt-get install pandoc lynx

답변

GitHub에는 사용할 수 있는 Markdown API 가 있습니다.