一般的な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
Jeromy Anglim

gitlabはKaTeXを使用
Foad

回答:


143

しかし、githubは数学記号に対して何も表示しません!助けてください、ありがとう!

GitHub マークダウン解析は、SunDown(ex libUpSkirt)ライブラリによって実行されます。

ライブラリのモットーは、 Cでの標準準拠の高速で安全な マークダウン処理ライブラリ」です。あなたの質問を考慮して、そこに「安全」である重要な言葉:)。

実際、JavaScriptの実行を許可することは、MarkDown標準のテキストからHTMLへのコントラクトとは少し異なります。

さらに、HTMLタグのように見えるものはすべてエスケープされるか、取り除かれます。

一般的なgithubマークダウンで数学記号を表示する方法を教えてください。

あなたの最善の策は、提供されたURLクエリ文字列を解析してオンザフライ画像を生成できるyuml.meに類似したWebサイトを見つけることです。

更新

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 Webサイトを使用して、ドキュメントに2つの式を追加しました。GitHubのドキュメントページを開くと、実際には異なるものの両方の数式が同じように表示されるという問題があります。なぜそれが起こるのか知っていますか?
サム

3
mathurl.comは、画像を生成する必要がある場合に注目すべきWebサイトでもあります。
Martin Thoma

2
これはgithubでは動作しないようですが。画像はレンダリングされません。誰もが理由を知っていますか?
OganM 2015

1
@OganM構文が変更されました。リンクは同様に固定され、GitHubの中でテストされています
nulltoken

1
iTex2Imgサイトが一貫して機能していないようです。画像がGithubに表示されないようです。
timbram

91

Markdownはインライン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サポートは、私が読みやすいLaTeXの上記の生のhtml構文を使用した場合にのみ機能しました。上記が機能しない場合は、代わりにURLエンコードレンダリングを選択し、その出力を使用して次のようなリンクを手動で作成します。

\ Large 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ノートブック(.ipynb)をに変換する必要が.mdあり、方程式は本質的に複数行のラテックスコードでした。
Marc Maxmeister

12

ブラウザで数学を自分で表示したいだけの場合は、MathJaxで Chrome拡張機能GitHubを試すことができます。とても便利です。


1
インストールしようとするとicon16.pngでエラーが発生します
Homero Esmeraldo

10

もう1つの回避策は、jupyterノートブックを使用し、セルでマークダウンモードを使用して方程式をレンダリングすることです。

中心的な方程式のように、基本的なものは完全に機能するようです

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

またはインライン方程式

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

しかし、私が本当に欲しかった機能の1つはgithubでまったくレンダリングされなかったものでしたが\mbox{}、これは残念でした。しかし、これらすべてがgithubで方程式をレンダリングする最も成功した方法でした。


3
この答えをありがとう、しかしこの問題があります:私はマークダウンモードでジュピターノートブックを使用することができ、方程式はOKと表示されます。しかし、今、このjupyterマークダウンreadme.mdをGitHubのに転送するにはどうすればよいですか?
DavidC。

1
数式はMarkdownファイルに直接レンダリングされません。方程式は、上にあるイメージである必要がありreadme.mdます。ただし、いつでもfile.ipynbgithubを使用するだけで、githubが適切にレンダリングします。
ヘキシクル2017

8

2020年になりました。ソースコードリポジトリホストの数式レンダリングサポートの進捗状況をまとめます。

GitHubとBitbucket

GitHubとBitbucket は、デフォルトの区切り文字かどうかにかかわらず、数式のレンダリングをサポートしいません

Bitbucket Cloud / BCLOUD-11192-MarkDownドキュメントにLaTeXサポートを追加(BB-12552)

GitHub /マークアップ-数式のレンダリング

GitHub /マークアップ-サポートラテックス

GitHubコミュニティフォーラム-[機能リクエスト] MarkdownのLaTeX Math

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フレーバーマークダウン-数学

誰がユニバーサル区切り文字をサポートしますか?

Hugoが使用するMarkdownパーサー

レンダリングするその他の方法


6

GitHubはMathJaxの数式を解釈しませんが、数式を画像に置き換えた新しいMarkdownドキュメントを自動的に生成できます。

GitHubアプリTeXifyをご覧になることをお勧めします。

プッシュで拡張子* .tex.mdのファイルを探し、それをTeX式としてSVG画像としてレンダリングするGitHubアプリ

それがどのように機能するか(ソースリポジトリから):

TeXifyをプッシュするたびに、最後のコミットで* .tex.mdファイルが実行および検索されます。それらのそれぞれに対して、ドル記号で囲まれたLaTeX式を取得するreadme2texを実行し、プレーンSVG画像に変換して、出力を.md拡張ファイルに保存します(つまり、README.tex.mdという名前のファイル処理され、出力はREADME.mdとして保存されます。その後、出力ファイルと新しいSVG画像がコミットされ、リポジトリにプッシュバックされます。


2

あなたの問題には良い解決策があります-TeXify githubプラグインを使用します(Tom Haleの回答で述べていますが、彼の回答は以下のリンクで作成しました)-この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:

このウェブサイトを使用して、ステップ2の出力を"eq"リクエストパラメータにコピーアンドペーストして画像を生成します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=)

以下の画像は、markdownの出力です。ばんざーい!


ここに画像の説明を入力してください


これを読んでいる人なら誰でも、「Typora」は私のお気に入りのマークダウンアプリです。ただ言う
デクスター

0

tex→image変換に関して、LaTeXiTツールははるかに高品質な出力を生成します。ほとんどのTeXディストリビューションでは標準だと思いますが、まだ持っていない場合はオンラインで見つけることができます。TeXに入れ、画像をデスクトップにドラッグしてから、デスクトップから画像ホスティングサイトにドラッグするだけです(私はimgurを使用しています)。


LaTeXiTはMacOSでのみ動作するようです(ただし、Webサイトでは明示的に述べられていません)。
ƒ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>

次に、次のmathjaxステートメントを入力しました
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}。$$
それは私のために働きました

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.