일반적인 github의 마크 다운에서 수학 방정식을 표시하는 방법 (github의 블로그 아님)


150

조사한 결과, mathjax가이를 수행 할 수 있음을 발견했습니다. 그러나 마크 다운 파일에 예제를 쓰면 올바른 방정식이 표시되지 않습니다.

마크 다운 파일 헤드에 이것을 추가했습니다.

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

그리고 mathjax 문을 입력하십시오 :

(E = mc ^ 2), $$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$

그러나 github는 수학 기호에 대해서는 아무것도 보여주지 않습니다! 도와주세요, 고마워요! github 마크 다운 페이지에 수학 기호를 표시하는 방법을 알려주십시오.


2
그것은 일반 사용자에 대한 문제가 해결되지 않습니다,하지만이 답변이 적어도 당신이 방정식을 볼 수 있도록 할 수있는 브라우저의 스크립트 제안 : stackoverflow.com/q/11255900/180892
제로미 Anglim

gitlab는 KaTeX를 사용
Foad

답변:


143

그러나 github는 수학 기호에 대해 아무것도 보여주지 않습니다! 도와주세요, 고마워요!

GitHub 마크 다운 파싱은 SunDown (예 : libUpSkirt) 라이브러리에 의해 수행됩니다 .

라이브러리의 좌우명은 "표준 준수, 빠르고, 안전합니다 마크 다운 처리 라이브러리" 입니다. 귀하의 질문을 고려하여 중요한 단어는 "보안 적"입니다 :).

실제로, 자바 스크립트가 실행되도록하는 것은 MarkDown 표준 텍스트 -HTML 계약에서 약간 벗어난 것입니다.

또한 HTML 태그처럼 보이는 모든 것이 이스케이프되거나 제거됩니다.

일반적인 github 마크 다운에서 수학 기호를 표시하는 방법을 알려주십시오.

가장 좋은 방법은 제공된 URL 쿼리 문자열을 파싱하여 즉시 이미지를 생성 할 수있는 yuml.me 와 유사한 웹 사이트를 찾는 것 입니다.

최신 정보

codedogs.com ( 더 이상 포함을 지원하지 않는 것 ) 또는 iTex2Img 와 같은 서비스를 사용자에게 제공하는 일부 사이트를 발견 했습니다 . 당신이 그들을 시도 할 수 있습니다. 물론, 다른 사람들이 존재할 수 있으며 일부 Google-fu가 도움이 될 것입니다.

다음과 같은 마크 다운 구문이 주어지면

![equation](http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

다음 이미지가 표시됩니다

방정식 http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

참고 : 이미지가 제대로 표시 되려면 URL의 쿼리 문자열 부분이 퍼센트 인코딩 되어 있는지 확인해야합니다 . www.url-encode-decode.com 과 같이 해당 작업에 도움이되는 온라인 도구를 쉽게 찾을 수 있습니다.


6
@nultoken, 유용한 답변에 감사드립니다. 위에서 언급 한 iTex2Img 웹 사이트를 사용했으며 문서에 두 가지 공식을 추가했습니다. GitHub에서 설명서 페이지를 열 때 두 수식이 실제로 다르게 표시되는 동안 두 수식이 동일하게 표시되는 문제가 있습니다. 왜 그런 일이 발생하는지 알고 싶습니까?
Sam

3
mathurl.com 은 이미지를 생성해야하는 경우 주목할만한 웹 사이트입니다.
Martin Thoma

2
그래도 github에서는 작동하지 않는 것 같습니다. 이미지가 렌더링되지 않습니다. 왜 그런지 아는 사람이 있습니까?
OganM

1
@OganM 구문이 변경되었습니다. 링크뿐만 아니라 고정 GitHub의에서 테스트되었습니다
nulltoken

1
iTex2Img 사이트가 지속적으로 작동하지 않는 것 같습니다. 이미지가 Github에서 렌더링되지 않는 것 같습니다.
timbram

91

마크 다운은 인라인 HTML을 지원합니다. 인라인 HTML은 빠르고 간단한 인라인 방정식과 외부 도구를 사용하여보다 복잡한 렌더링에 모두 사용할 수 있습니다.

빠르고 간단한 인라인

빠르고 간단한 인라인 항목의 경우 HTML 앰퍼샌드 및 엔티티 코드를 사용하십시오 . 이 아이디어를 마크 다운의 아래 첨자 텍스트와 결합하는 예는 다음과 같습니다. h θ (x) = θ o x + θ 1 x, 다음 코드.

    h<sub>&theta;</sub>(x) = &theta;<sub>o</sub> x + &theta;<sub>1</sub>x

일반적인 수학 기호에 대한 HTML 앰퍼샌드 엔티티 코드는 여기 에서 찾을 수 있습니다 . 그리스 문자 코드 여기 .

이 방법에는 한계가 있지만 실질적으로 모든 마크 다운에서 작동하며 외부 라이브러리가 필요하지 않습니다.

LaTeX 및 Codecogs로 복잡한 확장 가능한 인라인 렌더링

요구 사항이 더 큰 경우 CodeCogs와 같은 외부 LaTeX 렌더러를 사용하십시오. CodeCogs 편집기 로 방정식을 만듭니다 . 렌더링을 위해 svg를 선택하고 소스 코드를 위해 HTML을 선택하십시오. 크기 조정시 SVG가 잘 렌더링됩니다. HTML을 사용하면 소스를 볼 때 LaTeX를 쉽게 읽을 수 있습니다. 페이지 하단에서 퍼가기 코드를 복사하여 마크 다운에 붙여 넣습니다.

<img src="https://latex.codecogs.com/svg.latex?\Large&space;x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" title="\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" />

이것은이 결합 대답을 .

GitHub 는 위의 원시 HTML 구문을 사용하여 읽을 수있는 LaTeX를 사용하여 작업 한 시간 만 지원합니다. 위의 방법으로 문제가 해결되지 않으면 대신 URL 인코딩 렌더링을 선택 하고 해당 출력을 사용하여 다음과 같은 링크를 수동으로 만드는 것입니다.

\ 대형 x = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2a}

![\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}](https://latex.codecogs.com/svg.latex?x%3D%5Cfrac%7B-b%5Cpm%5Csqrt%7Bb%5E2-4ac%7D%7D%7B2a%7D)

이것은 수동으로 대체 이미지 텍스트에 LaTex를 통합하고 GitHub에서 렌더링하기 위해 인코딩 된 URL을 사용합니다.

멀티 라인 렌더링

여러 줄 렌더링이 필요한 경우이 답변을 확인하십시오 .


1
이것은 훌륭하게 작동했습니다. jupyter notebook (.ipynb)을로 변환해야했고 .md방정식은 본질적으로 여러 줄의 라텍스 코드였습니다.
Marc Maxmeister


10

다른 해결 방법은 jupyter 노트북을 사용하고 셀에서 마크 다운 모드를 사용하여 방정식을 렌더링하는 것입니다.

기본 방정식과 같은 기본 항목이 완벽하게 작동하는 것 같습니다.

\begin{equation}
...
\end{equation}

인라인 방정식

$ \sum_{\forall i}{x_i^{2}} $

비록 내가 정말로 원했던 기능 중 하나는 github에서 전혀 렌더링하지 않았지만 \mbox{}, 이것은 윙윙 거리는 소리였습니다. 그러나이 모든 것이 github에서 방정식을 렌더링하는 가장 성공적인 방법이었습니다.


3
이 답변에 감사드립니다. 그러나이 문제가 있습니다 : 마크 다운 모드에서 jupyter 노트북을 사용하고 방정식이 정상으로 나타납니다. 그러나 이제이 jupyter 마크 다운을 readme.mdGitHub 로 전송하는 방법은 무엇입니까?
DavidC.

1
수식은 마크 다운 파일에서 직접 렌더링되지 않습니다. 방정식은에 있어야 할 이미지 여야합니다 readme.md. 그러나 항상 file.ipynbgithub을 입을 수 있으며 github가 잘 렌더링합니다.
hexicle

8

이제 2020 년입니다. 소스 코드 저장소 호스트의 수학 공식 렌더링 지원 진행 상황을 요약하겠습니다.

GitHub 및 비트 버킷

GitHub와 Bitbucket 은 기본 구분자이든 다른 수식이든 여전히 수학 공식의 렌더링을 지원하지 않습니다 .

Bitbucket Cloud / BCLOUD-11192-MarkDown 문서에 LaTeX 지원 추가 (BB-12552)

GitHub / markup-렌더링 수학 방정식

GitHub / 마크 업-라텍스 지원

GitHub 커뮤니티 포럼-[기능 요청] LaTeX Math in Markdown

talk.commonmark.org-마크 다운에 수학 공식 추가 가능

GitHub는 최근 몇 년 동안 실질적인 진전이 거의 없었습니다.

GitLab

GitLab은 이미 지원되지만 가장 일반적인 방법은 아닙니다. 자체 구분 기호를 사용합니다.

This math is inline $`a^2+b^2=c^2`$.

This is on a separate line

```math
a^2+b^2=c^2
```

GitLab Flavored Markdown-수학

범용 분리 문자를 누가 지원합니까?

Hugo가 사용하는 Markdown 파서

렌더링하는 다른 방법


6

GitHub는 MathJax 공식을 해석하지 않지만 공식을 이미지로 대체하여 새 Markdown 문서를 자동으로 생성 할 수 있습니다.

GitHub 앱 TeXify 를 살펴 보십시오 .

확장명이 * .tex.md 인 파일을 찾아보고 SVG 이미지로 TeX 표현식으로 렌더링하는 GitHub 앱

작동 방식 ( 소스 리포지토리에서 ) :

푸시 할 때마다 TeXify는 마지막 커밋에서 * .tex.md 파일을 실행하고 검색합니다. 각각에 대해 readme2tex를 실행하여 달러 기호로 묶인 LaTeX 표현식을 가져 와서 일반 SVG 이미지로 변환 한 다음 출력을 .md 확장자 파일에 저장합니다 (즉, README.tex.md 파일 처리되고 출력은 README.md로 저장됩니다). 그런 다음 출력 파일과 새로운 SVG 이미지가 커밋되어 다시 리포지토리로 푸시됩니다.


2

사용 - 당신의 문제에 대한 좋은 해결책이 있습니다 TeXify GitHub의 플러그인 (언급 톰 헤일의 대답 -하지만 나는 그의 아래 링크에서 답 개발) - 이것은 당신이에서 찾을 수있는 좋은 방법입니다 왜 GitHub의 플러그인 및 설명에 대한 자세한 내용은 대답을 .


2

아래 언급 된 프로세스를 사용하여 방정식을 마크 다운으로 변환합니다. 이것은 나를 위해 아주 잘 작동합니다. 매우 간단합니다 !!

예를 들어, 행렬 곱셈 방정식을 표현하고 싶습니다

1 단계:

여기에서 수식 스크립트를 얻으십시오-https : //csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/

내 예 :Z(i,j)=X(i,k) * Y(k, j); k=1 to n 요약 수식 으로 표현 하고 싶었습니다 . 웹 사이트를 참조 할 때 필요한 스크립트는 =>

여기에 이미지 설명을 입력하십시오

Z_i_j=\sum_{k=1}^{10} X_i_k * Y_k_j

2 단계:

URL 인코더-https: //www.urlencoder.org/ 를 사용 하여 스크립트를 유효한 URL로 변환하십시오

. 내 예 :

여기에 이미지 설명을 입력하십시오

3 단계 :

이 웹 사이트를 사용하여 "eq" 요청 매개 변수에 2 단계의 출력을 복사하여 붙여 넣어 이미지를 생성하십시오 http://www.sciweavers.org/tex2img.php?eq=<b><i>paste-output-here</i></b>&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

.- 예 :
http://www.sciweavers.org/tex2img.php?eq=Z_i_j=\sum_{k = 1} ^ {10} % 20X_i_k % 20 * % 20Y_k_j & bc = White & fc = Black & im = jpg & fs = 12 & ff = arev & edit =

여기에 이미지 설명을 입력하십시오

4 단계 :

참조 이미지 인하 구문을 사용하여 - ![alt text](enter url here)

- 복사하고 좋은 당신의 인하에이 가고 :

![Z(i,j)=X(i,k) * Y(k, j); k=1 to n](http://www.sciweavers.org/tex2img.php?eq=Z_i_j%3D%5Csum_%7Bi%3D1%7D%5E%7B10%7D%20X_i_k%20%2A%20Y_k_j&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

아래 이미지는 마크 다운 출력입니다. 만세!!


여기에 이미지 설명을 입력하십시오


이 글을 읽는 사람이, "Typora는"단지 말을 나의 새로운 좋아 인하 애플 리케이션 ..입니다
덱스터

0

tex → 이미지 변환과 관련하여 LaTeXiT 도구는 훨씬 더 높은 품질의 출력을 생성합니다. 나는 그것이 대부분의 TeX 배포판에서 표준이라고 생각하지만, 아직 가지고 있지 않다면 온라인에서 찾을 수 있습니다. TeX에 이미지를 넣고 데스크탑으로 드래그 한 다음 데스크탑에서 이미지 호스팅 사이트로 드래그하면됩니다 (Imgur 사용).


LaTeXiT는 MacOS 에서만 작동하는 것 같습니다 (웹 사이트에 명시 적으로 명시되어 있지는 않지만).
ƒacu.-

0

마크 다운 파일 헤드에 다음을 사용했습니다.

<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js? 
config=TeX-MML-AM_CHTML"
</script>

그런 다음
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$ 와 같은 mathjax 문을 입력
했습니다 .

당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.