Linux 에서 Markdown 의 설치 및 상용 문법

설치 및 사용:
Linux 시스템 에서 markdown 을 편집 할 때 retext 도 구 를 사용 할 수 있 습 니 다.

# Debian/Ubuntu
sudo apt-get install retext
retext Release-Notes.md

markdown 파일 을 html 파일 로 변환 하려 면 discount 또는 python-markdown 패키지 로 제공 하 는 markdown:

# Debian/Ubuntu
sudo apt-get install discount

또는:

# Debian/Ubuntu
sudo apt-get install python-markdown

전환 작업 은 매우 간단 하 다.

#  discount   markdown  
markdown -o Release-Notes.html Release-Notes.md
#  python-markdown   markdown_py  
markdown_py -o html4 Release-Notest.md > Release-Notes.html

PDF 를 만 들 려 면 간단 합 니 다.python-pisa 가 제공 하 는 xhtml2pdf 를 사용 할 수 있 습 니 다.

# Debian/Ubuntu
sudo apt-get install python-pisa

#  html   PDF
xhtml2pdf --html Release-Notes.html Release-Notes.pdf

따라서 문서 디 렉 터 리 아래 에 Makefile 을 설치 하여 이 과정 을 자동 으로 진행 할 수 있 습 니 다.

# Makefile

MD = markdown
MDFLAGS = -T
H2P = xhtml2pdf
H2PFLAGS = --html
SOURCES := $(wildcard *.md)
OBJECTS := $(patsubst %.md, %.html, $(wildcard *.md))
OBJECTS_PDF := $(patsubst %.md, %.pdf, $(wildcard *.md))

all: build

build: html pdf

pdf: $(OBJECTS_PDF)

html: $(OBJECTS)

$(OBJECTS_PDF): %.pdf: %.html
    $(H2P) $(H2PFLAGS) $< > $@ 

$(OBJECTS): %.html: %.md
    $(MD) $(MDFLAGS) -o $@ $<
clean:
    rm -f $(OBJECTS)

이렇게 하면 현재 디 렉 터 리 에 있 는 모든 md 파일 의 pdf 나 html 출력 을 간단 한 명령 으로 생 성 할 수 있 습 니 다.

# html   
make html

# pdf  
make pdf

여기 서 문 제 는 markdown 의 내용 이 중국어 라면 변 환 된 html 가 브 라 우 저 에서 열 리 면 인 코딩 을 자동 으로 식별 할 수 없고 pdf 가 더 비참 하 며 바로 어 지 러 운 코드 입 니 다.이 때 우 리 는 markdown 이 html 태그 에 대한 지원 을 통 해 markdown 파일 에 인 코딩 정 보 를 추가 할 수 있 습 니 다.예 를 들 어 markdown 을 html 4 파일 로 변환 하려 면 파일 의 시작 에 meta 표 시 를 추가 하여 인 코딩 형식 을 가리 킬 수 있 습 니 다.

sed -i '1i\<meta http-equiv="content-type" content="text/html; charset=UTF-8">' *.md

이렇게 하면 돼.또한 최근 투 령 커 뮤 니 티 의 편집 시스템 을 사용 할 때 markdown 은 가끔 밑줄 을 긋 습 니 다()기울 임 꼴 로 표시 하면 함수 이름 이 이렇게 됩 니 다.

#     ssl_use_cabundle
sslusecabundle

나 는 기울 임 꼴 표 시 는 하나의 별표(*)를 사용 하고 굵 은 글씨 체 는 두 개의 별표(**)를 사용 하 는 것 을 권장 합 니 다.이렇게 사용 하면 훨씬 편리 합 니 다.물론 이 문제 자체 가 마크 다운 이 별표 나 밑줄 을 쳐 도 된다 고 말 하 는 것 이다.그러나 실제로 둘 다 지지 하 는 것 은 오히려 문제 가 될 수 있다.예 를 들 어 밑줄 친 곳 이 있다(굵 은 몸 ->굵 은 몸),어떤 곳 은 별표(*굵 은 몸**->굵 은 몸)를 사용 하여 오히려 혼 란 스 러 워 보인다(별표*를 선택 한 또 다른 이 유 는 밑줄 이 내용 에 나타 날 확률 이 별표 보다 훨씬 높다 는 것).
상용 문법:

*와_소포 의 텍스트 는 이 내용 을 강조 한다.예 를 들 어* *

**와__소포 의 텍스트 는 이 내용 을 굵게 표시 하고 HTML 의에 대응 합 니 다.예 를 들 어** **

스페이스 바*와_를 감 싸 면 강조 의 미 를 잃 고 글자 의 별표 나 밑줄

이 된다.

마크 다운 이 문 자 를 해석 하지 않 으 려 면\전의 로 바 꾸 기

줄 내 코드 는 반 따옴표`로 감 싸 줍 니 다

\#1 급 제목

\##2 급 제목

\#\#3 레벨 제목(최대 6 레벨 까지 가능)

>인용

*/+/-무질서 목록(등가)

숫자 를 사용 하 는 것 은 바로 서열 표 가 있 는데 어떤 숫자 든 지 간 에.그래서 당신 은 모든 목록 항목 에 1 을 추가 하 는 것 을 좋아 할 것 입 니 다.

목록 항목 에 인용(>)을 사용 하고 들 여 쓰기

네 개의 빈 칸 이나 TAB 생 성 코드 블록 을 들 여 씁 니 다

코드 블록 중&,<,>는 자동 으로 HTML 실체 로 전 환 됩 니 다

Markdown 은 코드 블록 과 줄 내 코드 에 있 는 Markdown 표 시 를 분석 하지 않 습 니 다

한 줄 에 세 개 이상*또는-을 넣 으 면 수평선

을 얻 을 수 있다.

링크:[ ]( )예[an example](http://example.com/)

로 컬 자원 을 참조 하고 상대 경 로 를 사용 합 니 다.[about me](/about/)

줄 내 사진:![Alt ](/path/to/img.jpg "Optional title"),태그

자동 연결.클릭 가능 한 링크 생 성:<http://example.com/>

도령 지역사회,저자 무 해 봉 
              hawstein