경량 마크 업 언어 비교 및 ​​대조 [닫기]

가장 인기있는 경량 마크 업 언어를 식별하고 강점과 약점을 비교하십시오. 이러한 언어는 문서와 같은 기술 산문을위한 범용 마크 업이어야합니다 (예 : Haml은 포함되지 않음).

참조 : Markdown 대 ReStructuredText

저는 더 큰 프로그래밍 및 기술 커뮤니티에서 일반적으로 사용되는 세 가지 주요 언어 인 Textile, Markdown 및 reStructuredText를 알고 있습니다. 세 가지 모두 몇 시간 내에 학습하거나 치트 시트를 가까이에두고 "날개"를 펼칠 수 있습니다.

직물

• Redmine 및 Ruby 커뮤니티에서 사용
• 현재 Stack Overflow에 태그가 지정된 113 개의 질문
• HTML과 가장 비슷하지만 가장 읽기 어려운 소스
• 세 언어 모두의 가장 쉬운 중첩 목록
• 프로그래머가 아니거나 HTML을 모르는 사람은 이해할 수 없음
• 복잡한 짧은 문서 (링크, 중첩 목록, 코드, 사용자 정의 HTML 포함)에 이상적입니다. 예 : 짧은 문서, 방법, 블로그 또는 CMS 콘텐츠
• 구문 참조

가격 인하

• 모국어 "커뮤니티"가없는 것 같지만 ...
• Stack Overflow *에 태그 된 1274 개의 질문
• 이메일 전통과 유사한 소스 코드 가독성을 강조합니다.
• 간단한 HTML 임베딩 (태그 만 입력하면 됨)
• HTML을 포함하는 것 외에는 표를 만들 수 없습니다.
• Stack Overflow를 알고 있다면 이미 알고 있습니다.
• reStructuredText를 이미 알고 있다면 배우기 쉽습니다.
• <address@example.com> 형식에 대한 자동 이메일 주소 난독 화 (꺾쇠 괄호 포함)
• 구문 참조

reStructuredText (일명 ReST)

• Python 커뮤니티에서 인기
• Stack Overflow에 태그 된 285 개의 질문
• 당신이 나에게 묻는다면 공백과 정렬에 대해 약간 까다로운
• 목록 (특히 중첩 목록)과 단락이 항상 싸우는 것처럼 보입니다.
• 프로그래머가 아닌 사람도 읽을 수 있음
• 목차를 만들 수있는 유일한 형식 (Python 참조 구현의 확장을 통해)
• PDF 및 XML과 같은 다른 형식으로 직접 변환
• 산문이 많은 대용량 문서에 적합 (예 : 사용자 설명서를위한 docbook의 대안)
• 구문 참조

asciidoc 을 고려할 수도 있습니다.

• 비교적 읽기 쉬운 마크 업
• 간단한 명령 줄 사용
• 일부는 구문과 관련하여 상대적으로 '까다 롭다'(유연성 대)라고 인식 할 수 있습니다.
• docbook 및 (x) html 출력

경량 마크 업 언어 에 대한 Wikipedia 페이지 는 다양한 옵션을 잘 비교하고 일반적인 용도 (제목, 굵게, 기울임 꼴 등)에 대한 구문을 보여줍니다.

여기에서 다양한 경량 마크 업 언어를 모두 다루려고합니다.

http://www.subspacefield.org/~travis/static_blog_generators.html

보시다시피, "안전한 블로그를 만드는 방법"(예 : 정적 HTML을 생성하는 블로그)으로 시작했습니다. 마크 업 언어, 템플릿 시스템 등에 얽매여 있습니다.

최신 정보

나는 파이썬 구현이있는 LWML에만 초점을 맞추었고, 여기에 있습니다.

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

지금까지 나는 마크 다운과 ReST를 시도해 보았고, 다른 페이지에 포함 된 HTML 스 니펫을 제외하고는 후자가 더 좋습니다. 테이블, 교차 참조, 간접 링크 등 ...

문서화? 방법에 대한 doxygen이 ?
문서화해야하는 일부 C / C ++ 프로젝트에 사용했습니다. doxygen 작성자가 doxygen 문서에 사용하는 것처럼 '남용'할 수도 있습니다.