web-dev-qa-db-ja.com

一般的なgithubのマークダウンで数式を表示する方法(githubのブログではありません)

調査した結果、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マークダウンで数学記号を表示する方法を教えてください。

115
alexunder

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

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

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

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

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

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

yuml.meに似たWebサイトを見つけることをお勧めします。これは、提供されたURLクエリ文字列を解析することでオンザフライ画像を生成できます。

更新

このようなサービスをユーザーに提供するサイトをいくつか見つけました: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のクエリ文字列部分がpercent encodedであることを確認する必要があります。 www.url-encode-decode.comなど、そのタスクに役立つオンラインツールを簡単に見つけることができます。

122
nulltoken

MarkdownはインラインHTMLをサポートしています。インラインHTMLは、迅速かつ単純なインライン方程式と、外部ツールを使用したより複雑なレンダリングの両方に使用できます。

すばやく簡単なインライン

すばやく簡単なインラインアイテムには、HTMLアンパサンド エンティティコード を使用します。この考えをマークダウンの添え字テキストと組み合わせる例は次のとおりです。hθ(x)=θo x +θ1x、後に続くコード。

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

一般的な数学記号のHTMLアンパサンドエンティティコードは、 here にあります。ギリシャ文字のコード ここ

このアプローチには制限がありますが、実質的にすべてのマークダウンで機能し、外部ライブラリを必要としません。

LaTeXとCodecogsを使用した複雑でスケーラブルなインラインレンダリング

ニーズが大きい場合は、CodeCogsなどの外部LaTeXレンダラーを使用します。 CodeCogs editor で方程式を作成します。レンダリングには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}" />

これは、この answer とこの answer を組み合わせたものです。

GitHubは、読み取り可能なLaTeXに対して上記の生のhtml構文を使用して動作する場合のみサポートします。上記がうまくいかない場合は、代わりにURL Encodedレンダリングを選択し、その出力を使用して次のようなリンクを手動で作成します:

\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)

これは、altイメージテキストにLaTexを手動で組み込み、GitHubでのレンダリングにエンコードされたURLを使用します。

マルチラインレンダリング

複数行のレンダリングが必要な場合は、この answer を確認してください。

55
SpeedCoder5

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

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

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

またはインライン方程式

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

しかし、私が本当に欲しかった関数の1つはgithubでまったくレンダリングしませんでしたが、\mbox{}でした。しかし、これはすべて、GitHubで方程式をレンダリングする最も成功した方法です。

8
chahuja

ブラウザで数学を表示したい場合は、Chrome拡張機能 GitHub with MathJax を試してみてください。とても便利です。

7
nn0p

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

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

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

仕組み( ソースリポジトリ から):

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

3
Tom Hale

あなたの問題には良い解決策があります- TeXify github pluginを使用します( Tom Hale answerで言及-しかし、下のリンクで彼の答えを開発しました)-このgithub pluginの詳細そして、これが良いアプローチである理由を説明します answer

0

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

0
fredcallaway