Latex rendering in README.md on Github












53















Is there any way to render LaTex in README.md in a GitHub repository? I've googled it and searched on stack overflow but none of the related answers seems feasible.










share|improve this question


















  • 1





    It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

    – Waylan
    Feb 19 '16 at 14:13











  • Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

    – user90593
    Feb 19 '16 at 15:46











  • See this related post: How to show math equations in general github's markdown(not github's blog).

    – Waylan
    Feb 19 '16 at 16:07











  • Also this: LaTeX math in github wikis.

    – Waylan
    Feb 19 '16 at 16:10











  • Also stackoverflow.com/questions/48511527/…

    – EPo
    Sep 22 '18 at 4:58
















53















Is there any way to render LaTex in README.md in a GitHub repository? I've googled it and searched on stack overflow but none of the related answers seems feasible.










share|improve this question


















  • 1





    It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

    – Waylan
    Feb 19 '16 at 14:13











  • Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

    – user90593
    Feb 19 '16 at 15:46











  • See this related post: How to show math equations in general github's markdown(not github's blog).

    – Waylan
    Feb 19 '16 at 16:07











  • Also this: LaTeX math in github wikis.

    – Waylan
    Feb 19 '16 at 16:10











  • Also stackoverflow.com/questions/48511527/…

    – EPo
    Sep 22 '18 at 4:58














53












53








53


11






Is there any way to render LaTex in README.md in a GitHub repository? I've googled it and searched on stack overflow but none of the related answers seems feasible.










share|improve this question














Is there any way to render LaTex in README.md in a GitHub repository? I've googled it and searched on stack overflow but none of the related answers seems feasible.







github latex markdown






share|improve this question













share|improve this question











share|improve this question




share|improve this question










asked Feb 19 '16 at 6:15









user90593user90593

4001410




4001410








  • 1





    It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

    – Waylan
    Feb 19 '16 at 14:13











  • Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

    – user90593
    Feb 19 '16 at 15:46











  • See this related post: How to show math equations in general github's markdown(not github's blog).

    – Waylan
    Feb 19 '16 at 16:07











  • Also this: LaTeX math in github wikis.

    – Waylan
    Feb 19 '16 at 16:10











  • Also stackoverflow.com/questions/48511527/…

    – EPo
    Sep 22 '18 at 4:58














  • 1





    It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

    – Waylan
    Feb 19 '16 at 14:13











  • Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

    – user90593
    Feb 19 '16 at 15:46











  • See this related post: How to show math equations in general github's markdown(not github's blog).

    – Waylan
    Feb 19 '16 at 16:07











  • Also this: LaTeX math in github wikis.

    – Waylan
    Feb 19 '16 at 16:10











  • Also stackoverflow.com/questions/48511527/…

    – EPo
    Sep 22 '18 at 4:58








1




1





It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

– Waylan
Feb 19 '16 at 14:13





It is not possible directly. Is there some specific thing that you think you need LaTex for? For example, if you want math equations, that may be doable with some specific tricks. Tell us what you want to render, and someone might be able to point you to a workaround.

– Waylan
Feb 19 '16 at 14:13













Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

– user90593
Feb 19 '16 at 15:46





Yes I want math equations and aligned equations, along with inlined math symbols. That's pretty much it.

– user90593
Feb 19 '16 at 15:46













See this related post: How to show math equations in general github's markdown(not github's blog).

– Waylan
Feb 19 '16 at 16:07





See this related post: How to show math equations in general github's markdown(not github's blog).

– Waylan
Feb 19 '16 at 16:07













Also this: LaTeX math in github wikis.

– Waylan
Feb 19 '16 at 16:10





Also this: LaTeX math in github wikis.

– Waylan
Feb 19 '16 at 16:10













Also stackoverflow.com/questions/48511527/…

– EPo
Sep 22 '18 at 4:58





Also stackoverflow.com/questions/48511527/…

– EPo
Sep 22 '18 at 4:58












7 Answers
7






active

oldest

votes


















16














For short expresions and not so fancy math you could use the inline HTML to get your latex rendered math on codecogs and then embed the resulting image. Here an example:



- <img src="https://latex.codecogs.com/gif.latex?O_t=text { Onset event at time bin } t " /> 
- <img src="https://latex.codecogs.com/gif.latex?s=text { sensor reading } " />
- <img src="https://latex.codecogs.com/gif.latex?P(s | O_t )=text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " />


Which should result in something like the next









Update: This works great in eclipse but not in github unfortunately. The only work around is the next:



Take your latex equation and go to http://www.codecogs.com/latex/eqneditor.php, at the bottom of the area where your equation appears displayed there is a tiny dropdown menu, pick URL encoded and then paste that in your github markdown in the next way:



![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t)
![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D)
![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)





share|improve this answer

































    13














    Readme2Tex



    I've been working on a script that automates most of the cruft out of getting LaTeX typeset nicely into Github-flavored markdown: https://github.com/leegao/readme2tex



    There are a few challenges with rendering LaTeX for Github. First, Github-flavored markdown strips most tags and most attributes. This means no Javascript based libraries (like Mathjax) nor any CSS styling.



    The natural solution then seems to be to embed images of precompiled equations. However, you'll soon realize that LaTeX does more than just turning dollar-sign enclosed formulas into images.



    enter image description here



    Simply embedding images from online compilers gives this really unnatural look to your document. In fact, I would argue that it's even more readable in your everyday x^2 mathematical slang than jumpy .



    I believe that making sure that your documents are typeset in a natural and readable way is important. This is why I wrote a script that, beyond compiling formulas into images, also ensures that the resulting image is properly fitted and aligned to the rest of the text.



    For example, here is an excerpt from a .md file regarding some enumerative properties of regular expressions typeset using readme2tex:



    enter image description here



    As you might expect, the set of equations at the top is specified by just starting the corresponding align* environment



    **Theorem**: The translation $[![e]!]$ given by
    begin{align*}
    ...
    end{align*}
    ...


    Notice that while inline equations ($...$) run with the text, display equations (those that are delimited by begin{ENV}...end{ENV} or $$...$$) are centered. This makes it easy for people who are already accustomed to LaTeX to keep being productive.



    If this sounds like something that could help, make sure to check it out. https://github.com/leegao/readme2tex






    share|improve this answer



















    • 8





      Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

      – agurodriguez
      Aug 15 '17 at 17:58






    • 2





      Nice! That's actually really awesome of you to do :)

      – Lee
      Aug 25 '17 at 4:56



















    5














    My trick is to use the Jupyter Notebook.



    GitHub has built-in support for rendering .ipynb files. You can write inline and display LaTeX code in the notebook and GitHub will render it for you.



    Here's a sample notebook file: https://gist.github.com/cyhsutw/d5983d166fb70ff651f027b2aa56ee4e






    share|improve this answer































      4














      One can also use this online editor: https://www.codecogs.com/latex/eqneditor.php which generates SVG files on the fly. You can put a link in your document like this:
      !(https://latex.codecogs.com/svg.latex?y%3Dx%5E2) which results in:
      .






      share|improve this answer































        4














        For automatic conversion upon push to GitHub, take a look at the TeXify app:




        GitHub App that looks in your pushes for files with extension *.tex.md and renders it's TeX expressions as SVG images




        How it works (from the source repository):




        Whenever you push TeXify will run and seach for *.tex.md files in your last commit. For each one of those it'll run readme2tex which will take LaTeX expressions enclosed between dollar signs, convert it to plain SVG images, and then save the output into a .md extension file (That means that a file named README.tex.md will be processed and the output will be saved as README.md). After that, the output file and the new SVG images are then commited and pushed back to your repo.







        share|improve this answer





















        • 1





          This work is by @agurodriguez who mentions it in a comment above

          – icc97
          Jan 13 at 14:12











        • @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

          – Kamil Kiełczewski
          Jan 16 at 12:09








        • 2





          @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

          – icc97
          Jan 18 at 6:54





















        3














        I test some solution proposed by others and I would like to recommend TeXify created and proposed in comment by agurodriguez and further described by Tom Hale - I would like develop his answer and give some reason why this is very good solution:




        • TeXify is wrapper of Readme2Tex (mention in Lee answer). To use Readme2Tex you must install a lot of software in your local machine (python, latex, ...) - but TeXify is github plugin so you don't need to install anything in your local machine - you only need to online installation that plugin in you github account by pressing one button and choose repositories for which TeXify will have read/write access to parse your tex formulas and generate pictures.

        • When in your repository you create or update *.tex.md file, the TeXify will detect changes and generate *.md file where latex formulas will be exchanged by its pictures saved in tex directory in your repo. So if you create README.tex.md file then TeXify will generate README.md with pictures instead tex formulas. So parsing tex formulas and generate documentation is done automagically on each commit&push :)

        • Because all your formulas are changed into pictures in tex directory and README.md file use links to that pictures, you can even uninstall TeXify and all your old documentation will still works :). The tex directory and *.tex.md files will stay on repository so you have access to your original latex formulas and pictures (you can also safely store in tex directory your other documentation pictures "made by hand" - TeXify will not touch them).


        • You can use equations latex syntax directly in README.tex.md file (without loosing .md markdown syntax) which is very handy. Julii in his answer proposed to use special links (with formulas) to external service e.g . http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D which is good however has some drawbacks: the formulas in links are not easy (handy) to read and update, and if there will be some problem with that third-party service your old documentation will stop work... In TeXify your old documentation will works always even if you uninstall that plugin (because all your pictures generated from latex formulas are stay in repo in tex directory).

        • The Yuchao Jiang in his answer, proposed to use Jupyter Notebook which is also nice however have som drawbacks: you cannot use formulas directly in README.md file, you need to make link there to other file *.ipynb in your repo which contains latex (MathJax) formulas. The file *.ipynb format is JSON which is not handy to maintain (e.g. Gist don't show detailed error with line number in *.ipynb file when you forgot to put comma in proper place...).


        Here is link to some of my repo where I use TeXify for which documentation was generated from README.tex.md file.






        share|improve this answer


























        • Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

          – Royi
          Jan 16 at 10:23











        • @Royi I don't know

          – Kamil Kiełczewski
          Jan 16 at 10:50



















        1














        I upload repositories with equations to Gitlab because it has native support for LaTeX in .md files:



        ```math
        SE = frac{sigma}{sqrt{n}}
        ```


        The syntax for inline latex is $`sqrt{2}`$.



        Gitlab renders equations with JavaScript in the browser instead of showing images, which improves the quality of equations.



        More info here.



        Let's hope Github will implement this as well in the future.






        share|improve this answer

























          Your Answer






          StackExchange.ifUsing("editor", function () {
          StackExchange.using("externalEditor", function () {
          StackExchange.using("snippets", function () {
          StackExchange.snippets.init();
          });
          });
          }, "code-snippets");

          StackExchange.ready(function() {
          var channelOptions = {
          tags: "".split(" "),
          id: "1"
          };
          initTagRenderer("".split(" "), "".split(" "), channelOptions);

          StackExchange.using("externalEditor", function() {
          // Have to fire editor after snippets, if snippets enabled
          if (StackExchange.settings.snippets.snippetsEnabled) {
          StackExchange.using("snippets", function() {
          createEditor();
          });
          }
          else {
          createEditor();
          }
          });

          function createEditor() {
          StackExchange.prepareEditor({
          heartbeatType: 'answer',
          autoActivateHeartbeat: false,
          convertImagesToLinks: true,
          noModals: true,
          showLowRepImageUploadWarning: true,
          reputationToPostImages: 10,
          bindNavPrevention: true,
          postfix: "",
          imageUploader: {
          brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
          contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
          allowUrls: true
          },
          onDemand: true,
          discardSelector: ".discard-answer"
          ,immediatelyShowMarkdownHelp:true
          });


          }
          });














          draft saved

          draft discarded


















          StackExchange.ready(
          function () {
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f35498525%2flatex-rendering-in-readme-md-on-github%23new-answer', 'question_page');
          }
          );

          Post as a guest















          Required, but never shown

























          7 Answers
          7






          active

          oldest

          votes








          7 Answers
          7






          active

          oldest

          votes









          active

          oldest

          votes






          active

          oldest

          votes









          16














          For short expresions and not so fancy math you could use the inline HTML to get your latex rendered math on codecogs and then embed the resulting image. Here an example:



          - <img src="https://latex.codecogs.com/gif.latex?O_t=text { Onset event at time bin } t " /> 
          - <img src="https://latex.codecogs.com/gif.latex?s=text { sensor reading } " />
          - <img src="https://latex.codecogs.com/gif.latex?P(s | O_t )=text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " />


          Which should result in something like the next









          Update: This works great in eclipse but not in github unfortunately. The only work around is the next:



          Take your latex equation and go to http://www.codecogs.com/latex/eqneditor.php, at the bottom of the area where your equation appears displayed there is a tiny dropdown menu, pick URL encoded and then paste that in your github markdown in the next way:



          ![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t)
          ![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D)
          ![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)





          share|improve this answer






























            16














            For short expresions and not so fancy math you could use the inline HTML to get your latex rendered math on codecogs and then embed the resulting image. Here an example:



            - <img src="https://latex.codecogs.com/gif.latex?O_t=text { Onset event at time bin } t " /> 
            - <img src="https://latex.codecogs.com/gif.latex?s=text { sensor reading } " />
            - <img src="https://latex.codecogs.com/gif.latex?P(s | O_t )=text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " />


            Which should result in something like the next









            Update: This works great in eclipse but not in github unfortunately. The only work around is the next:



            Take your latex equation and go to http://www.codecogs.com/latex/eqneditor.php, at the bottom of the area where your equation appears displayed there is a tiny dropdown menu, pick URL encoded and then paste that in your github markdown in the next way:



            ![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t)
            ![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D)
            ![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)





            share|improve this answer




























              16












              16








              16







              For short expresions and not so fancy math you could use the inline HTML to get your latex rendered math on codecogs and then embed the resulting image. Here an example:



              - <img src="https://latex.codecogs.com/gif.latex?O_t=text { Onset event at time bin } t " /> 
              - <img src="https://latex.codecogs.com/gif.latex?s=text { sensor reading } " />
              - <img src="https://latex.codecogs.com/gif.latex?P(s | O_t )=text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " />


              Which should result in something like the next









              Update: This works great in eclipse but not in github unfortunately. The only work around is the next:



              Take your latex equation and go to http://www.codecogs.com/latex/eqneditor.php, at the bottom of the area where your equation appears displayed there is a tiny dropdown menu, pick URL encoded and then paste that in your github markdown in the next way:



              ![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t)
              ![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D)
              ![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)





              share|improve this answer















              For short expresions and not so fancy math you could use the inline HTML to get your latex rendered math on codecogs and then embed the resulting image. Here an example:



              - <img src="https://latex.codecogs.com/gif.latex?O_t=text { Onset event at time bin } t " /> 
              - <img src="https://latex.codecogs.com/gif.latex?s=text { sensor reading } " />
              - <img src="https://latex.codecogs.com/gif.latex?P(s | O_t )=text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " />


              Which should result in something like the next









              Update: This works great in eclipse but not in github unfortunately. The only work around is the next:



              Take your latex equation and go to http://www.codecogs.com/latex/eqneditor.php, at the bottom of the area where your equation appears displayed there is a tiny dropdown menu, pick URL encoded and then paste that in your github markdown in the next way:



              ![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t)
              ![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D)
              ![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)






              share|improve this answer














              share|improve this answer



              share|improve this answer








              edited Aug 10 '17 at 3:29

























              answered Aug 10 '17 at 2:38









              JuliJuli

              303212




              303212

























                  13














                  Readme2Tex



                  I've been working on a script that automates most of the cruft out of getting LaTeX typeset nicely into Github-flavored markdown: https://github.com/leegao/readme2tex



                  There are a few challenges with rendering LaTeX for Github. First, Github-flavored markdown strips most tags and most attributes. This means no Javascript based libraries (like Mathjax) nor any CSS styling.



                  The natural solution then seems to be to embed images of precompiled equations. However, you'll soon realize that LaTeX does more than just turning dollar-sign enclosed formulas into images.



                  enter image description here



                  Simply embedding images from online compilers gives this really unnatural look to your document. In fact, I would argue that it's even more readable in your everyday x^2 mathematical slang than jumpy .



                  I believe that making sure that your documents are typeset in a natural and readable way is important. This is why I wrote a script that, beyond compiling formulas into images, also ensures that the resulting image is properly fitted and aligned to the rest of the text.



                  For example, here is an excerpt from a .md file regarding some enumerative properties of regular expressions typeset using readme2tex:



                  enter image description here



                  As you might expect, the set of equations at the top is specified by just starting the corresponding align* environment



                  **Theorem**: The translation $[![e]!]$ given by
                  begin{align*}
                  ...
                  end{align*}
                  ...


                  Notice that while inline equations ($...$) run with the text, display equations (those that are delimited by begin{ENV}...end{ENV} or $$...$$) are centered. This makes it easy for people who are already accustomed to LaTeX to keep being productive.



                  If this sounds like something that could help, make sure to check it out. https://github.com/leegao/readme2tex






                  share|improve this answer



















                  • 8





                    Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                    – agurodriguez
                    Aug 15 '17 at 17:58






                  • 2





                    Nice! That's actually really awesome of you to do :)

                    – Lee
                    Aug 25 '17 at 4:56
















                  13














                  Readme2Tex



                  I've been working on a script that automates most of the cruft out of getting LaTeX typeset nicely into Github-flavored markdown: https://github.com/leegao/readme2tex



                  There are a few challenges with rendering LaTeX for Github. First, Github-flavored markdown strips most tags and most attributes. This means no Javascript based libraries (like Mathjax) nor any CSS styling.



                  The natural solution then seems to be to embed images of precompiled equations. However, you'll soon realize that LaTeX does more than just turning dollar-sign enclosed formulas into images.



                  enter image description here



                  Simply embedding images from online compilers gives this really unnatural look to your document. In fact, I would argue that it's even more readable in your everyday x^2 mathematical slang than jumpy .



                  I believe that making sure that your documents are typeset in a natural and readable way is important. This is why I wrote a script that, beyond compiling formulas into images, also ensures that the resulting image is properly fitted and aligned to the rest of the text.



                  For example, here is an excerpt from a .md file regarding some enumerative properties of regular expressions typeset using readme2tex:



                  enter image description here



                  As you might expect, the set of equations at the top is specified by just starting the corresponding align* environment



                  **Theorem**: The translation $[![e]!]$ given by
                  begin{align*}
                  ...
                  end{align*}
                  ...


                  Notice that while inline equations ($...$) run with the text, display equations (those that are delimited by begin{ENV}...end{ENV} or $$...$$) are centered. This makes it easy for people who are already accustomed to LaTeX to keep being productive.



                  If this sounds like something that could help, make sure to check it out. https://github.com/leegao/readme2tex






                  share|improve this answer



















                  • 8





                    Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                    – agurodriguez
                    Aug 15 '17 at 17:58






                  • 2





                    Nice! That's actually really awesome of you to do :)

                    – Lee
                    Aug 25 '17 at 4:56














                  13












                  13








                  13







                  Readme2Tex



                  I've been working on a script that automates most of the cruft out of getting LaTeX typeset nicely into Github-flavored markdown: https://github.com/leegao/readme2tex



                  There are a few challenges with rendering LaTeX for Github. First, Github-flavored markdown strips most tags and most attributes. This means no Javascript based libraries (like Mathjax) nor any CSS styling.



                  The natural solution then seems to be to embed images of precompiled equations. However, you'll soon realize that LaTeX does more than just turning dollar-sign enclosed formulas into images.



                  enter image description here



                  Simply embedding images from online compilers gives this really unnatural look to your document. In fact, I would argue that it's even more readable in your everyday x^2 mathematical slang than jumpy .



                  I believe that making sure that your documents are typeset in a natural and readable way is important. This is why I wrote a script that, beyond compiling formulas into images, also ensures that the resulting image is properly fitted and aligned to the rest of the text.



                  For example, here is an excerpt from a .md file regarding some enumerative properties of regular expressions typeset using readme2tex:



                  enter image description here



                  As you might expect, the set of equations at the top is specified by just starting the corresponding align* environment



                  **Theorem**: The translation $[![e]!]$ given by
                  begin{align*}
                  ...
                  end{align*}
                  ...


                  Notice that while inline equations ($...$) run with the text, display equations (those that are delimited by begin{ENV}...end{ENV} or $$...$$) are centered. This makes it easy for people who are already accustomed to LaTeX to keep being productive.



                  If this sounds like something that could help, make sure to check it out. https://github.com/leegao/readme2tex






                  share|improve this answer













                  Readme2Tex



                  I've been working on a script that automates most of the cruft out of getting LaTeX typeset nicely into Github-flavored markdown: https://github.com/leegao/readme2tex



                  There are a few challenges with rendering LaTeX for Github. First, Github-flavored markdown strips most tags and most attributes. This means no Javascript based libraries (like Mathjax) nor any CSS styling.



                  The natural solution then seems to be to embed images of precompiled equations. However, you'll soon realize that LaTeX does more than just turning dollar-sign enclosed formulas into images.



                  enter image description here



                  Simply embedding images from online compilers gives this really unnatural look to your document. In fact, I would argue that it's even more readable in your everyday x^2 mathematical slang than jumpy .



                  I believe that making sure that your documents are typeset in a natural and readable way is important. This is why I wrote a script that, beyond compiling formulas into images, also ensures that the resulting image is properly fitted and aligned to the rest of the text.



                  For example, here is an excerpt from a .md file regarding some enumerative properties of regular expressions typeset using readme2tex:



                  enter image description here



                  As you might expect, the set of equations at the top is specified by just starting the corresponding align* environment



                  **Theorem**: The translation $[![e]!]$ given by
                  begin{align*}
                  ...
                  end{align*}
                  ...


                  Notice that while inline equations ($...$) run with the text, display equations (those that are delimited by begin{ENV}...end{ENV} or $$...$$) are centered. This makes it easy for people who are already accustomed to LaTeX to keep being productive.



                  If this sounds like something that could help, make sure to check it out. https://github.com/leegao/readme2tex







                  share|improve this answer












                  share|improve this answer



                  share|improve this answer










                  answered Dec 27 '16 at 8:55









                  LeeLee

                  312148




                  312148








                  • 8





                    Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                    – agurodriguez
                    Aug 15 '17 at 17:58






                  • 2





                    Nice! That's actually really awesome of you to do :)

                    – Lee
                    Aug 25 '17 at 4:56














                  • 8





                    Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                    – agurodriguez
                    Aug 15 '17 at 17:58






                  • 2





                    Nice! That's actually really awesome of you to do :)

                    – Lee
                    Aug 25 '17 at 4:56








                  8




                  8





                  Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                  – agurodriguez
                  Aug 15 '17 at 17:58





                  Based on this work I've created a GitHub app that automates the rendering process, triggering it every time a push is made. I think it's useful so I share the link for those who wants to give it a try: github.com/agurz/github-texify

                  – agurodriguez
                  Aug 15 '17 at 17:58




                  2




                  2





                  Nice! That's actually really awesome of you to do :)

                  – Lee
                  Aug 25 '17 at 4:56





                  Nice! That's actually really awesome of you to do :)

                  – Lee
                  Aug 25 '17 at 4:56











                  5














                  My trick is to use the Jupyter Notebook.



                  GitHub has built-in support for rendering .ipynb files. You can write inline and display LaTeX code in the notebook and GitHub will render it for you.



                  Here's a sample notebook file: https://gist.github.com/cyhsutw/d5983d166fb70ff651f027b2aa56ee4e






                  share|improve this answer




























                    5














                    My trick is to use the Jupyter Notebook.



                    GitHub has built-in support for rendering .ipynb files. You can write inline and display LaTeX code in the notebook and GitHub will render it for you.



                    Here's a sample notebook file: https://gist.github.com/cyhsutw/d5983d166fb70ff651f027b2aa56ee4e






                    share|improve this answer


























                      5












                      5








                      5







                      My trick is to use the Jupyter Notebook.



                      GitHub has built-in support for rendering .ipynb files. You can write inline and display LaTeX code in the notebook and GitHub will render it for you.



                      Here's a sample notebook file: https://gist.github.com/cyhsutw/d5983d166fb70ff651f027b2aa56ee4e






                      share|improve this answer













                      My trick is to use the Jupyter Notebook.



                      GitHub has built-in support for rendering .ipynb files. You can write inline and display LaTeX code in the notebook and GitHub will render it for you.



                      Here's a sample notebook file: https://gist.github.com/cyhsutw/d5983d166fb70ff651f027b2aa56ee4e







                      share|improve this answer












                      share|improve this answer



                      share|improve this answer










                      answered Jul 13 '18 at 21:19









                      Yuchao JiangYuchao Jiang

                      74279




                      74279























                          4














                          One can also use this online editor: https://www.codecogs.com/latex/eqneditor.php which generates SVG files on the fly. You can put a link in your document like this:
                          !(https://latex.codecogs.com/svg.latex?y%3Dx%5E2) which results in:
                          .






                          share|improve this answer




























                            4














                            One can also use this online editor: https://www.codecogs.com/latex/eqneditor.php which generates SVG files on the fly. You can put a link in your document like this:
                            !(https://latex.codecogs.com/svg.latex?y%3Dx%5E2) which results in:
                            .






                            share|improve this answer


























                              4












                              4








                              4







                              One can also use this online editor: https://www.codecogs.com/latex/eqneditor.php which generates SVG files on the fly. You can put a link in your document like this:
                              !(https://latex.codecogs.com/svg.latex?y%3Dx%5E2) which results in:
                              .






                              share|improve this answer













                              One can also use this online editor: https://www.codecogs.com/latex/eqneditor.php which generates SVG files on the fly. You can put a link in your document like this:
                              !(https://latex.codecogs.com/svg.latex?y%3Dx%5E2) which results in:
                              .







                              share|improve this answer












                              share|improve this answer



                              share|improve this answer










                              answered Feb 21 '17 at 13:09









                              Dylan Richard MuirDylan Richard Muir

                              416316




                              416316























                                  4














                                  For automatic conversion upon push to GitHub, take a look at the TeXify app:




                                  GitHub App that looks in your pushes for files with extension *.tex.md and renders it's TeX expressions as SVG images




                                  How it works (from the source repository):




                                  Whenever you push TeXify will run and seach for *.tex.md files in your last commit. For each one of those it'll run readme2tex which will take LaTeX expressions enclosed between dollar signs, convert it to plain SVG images, and then save the output into a .md extension file (That means that a file named README.tex.md will be processed and the output will be saved as README.md). After that, the output file and the new SVG images are then commited and pushed back to your repo.







                                  share|improve this answer





















                                  • 1





                                    This work is by @agurodriguez who mentions it in a comment above

                                    – icc97
                                    Jan 13 at 14:12











                                  • @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                    – Kamil Kiełczewski
                                    Jan 16 at 12:09








                                  • 2





                                    @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                    – icc97
                                    Jan 18 at 6:54


















                                  4














                                  For automatic conversion upon push to GitHub, take a look at the TeXify app:




                                  GitHub App that looks in your pushes for files with extension *.tex.md and renders it's TeX expressions as SVG images




                                  How it works (from the source repository):




                                  Whenever you push TeXify will run and seach for *.tex.md files in your last commit. For each one of those it'll run readme2tex which will take LaTeX expressions enclosed between dollar signs, convert it to plain SVG images, and then save the output into a .md extension file (That means that a file named README.tex.md will be processed and the output will be saved as README.md). After that, the output file and the new SVG images are then commited and pushed back to your repo.







                                  share|improve this answer





















                                  • 1





                                    This work is by @agurodriguez who mentions it in a comment above

                                    – icc97
                                    Jan 13 at 14:12











                                  • @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                    – Kamil Kiełczewski
                                    Jan 16 at 12:09








                                  • 2





                                    @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                    – icc97
                                    Jan 18 at 6:54
















                                  4












                                  4








                                  4







                                  For automatic conversion upon push to GitHub, take a look at the TeXify app:




                                  GitHub App that looks in your pushes for files with extension *.tex.md and renders it's TeX expressions as SVG images




                                  How it works (from the source repository):




                                  Whenever you push TeXify will run and seach for *.tex.md files in your last commit. For each one of those it'll run readme2tex which will take LaTeX expressions enclosed between dollar signs, convert it to plain SVG images, and then save the output into a .md extension file (That means that a file named README.tex.md will be processed and the output will be saved as README.md). After that, the output file and the new SVG images are then commited and pushed back to your repo.







                                  share|improve this answer















                                  For automatic conversion upon push to GitHub, take a look at the TeXify app:




                                  GitHub App that looks in your pushes for files with extension *.tex.md and renders it's TeX expressions as SVG images




                                  How it works (from the source repository):




                                  Whenever you push TeXify will run and seach for *.tex.md files in your last commit. For each one of those it'll run readme2tex which will take LaTeX expressions enclosed between dollar signs, convert it to plain SVG images, and then save the output into a .md extension file (That means that a file named README.tex.md will be processed and the output will be saved as README.md). After that, the output file and the new SVG images are then commited and pushed back to your repo.








                                  share|improve this answer














                                  share|improve this answer



                                  share|improve this answer








                                  edited Jan 1 at 10:44

























                                  answered Jun 2 '18 at 4:52









                                  Tom HaleTom Hale

                                  7,3064759




                                  7,3064759








                                  • 1





                                    This work is by @agurodriguez who mentions it in a comment above

                                    – icc97
                                    Jan 13 at 14:12











                                  • @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                    – Kamil Kiełczewski
                                    Jan 16 at 12:09








                                  • 2





                                    @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                    – icc97
                                    Jan 18 at 6:54
















                                  • 1





                                    This work is by @agurodriguez who mentions it in a comment above

                                    – icc97
                                    Jan 13 at 14:12











                                  • @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                    – Kamil Kiełczewski
                                    Jan 16 at 12:09








                                  • 2





                                    @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                    – icc97
                                    Jan 18 at 6:54










                                  1




                                  1





                                  This work is by @agurodriguez who mentions it in a comment above

                                  – icc97
                                  Jan 13 at 14:12





                                  This work is by @agurodriguez who mentions it in a comment above

                                  – icc97
                                  Jan 13 at 14:12













                                  @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                  – Kamil Kiełczewski
                                  Jan 16 at 12:09







                                  @icc97 yes, but agurodriguez not create answer (and I will probably never notice his comment). Because Tom create answer (~1 year after agurodriguez) I notce that TeXify exists and it allows me to use TeXify and write my own answer base on this. So it was good :)

                                  – Kamil Kiełczewski
                                  Jan 16 at 12:09






                                  2




                                  2





                                  @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                  – icc97
                                  Jan 18 at 6:54







                                  @KamilKiełczewski There's nothing wrong with this answer, I'm just mentioning that TeXify was created by a SO user because of this thread, which is pretty cool.

                                  – icc97
                                  Jan 18 at 6:54













                                  3














                                  I test some solution proposed by others and I would like to recommend TeXify created and proposed in comment by agurodriguez and further described by Tom Hale - I would like develop his answer and give some reason why this is very good solution:




                                  • TeXify is wrapper of Readme2Tex (mention in Lee answer). To use Readme2Tex you must install a lot of software in your local machine (python, latex, ...) - but TeXify is github plugin so you don't need to install anything in your local machine - you only need to online installation that plugin in you github account by pressing one button and choose repositories for which TeXify will have read/write access to parse your tex formulas and generate pictures.

                                  • When in your repository you create or update *.tex.md file, the TeXify will detect changes and generate *.md file where latex formulas will be exchanged by its pictures saved in tex directory in your repo. So if you create README.tex.md file then TeXify will generate README.md with pictures instead tex formulas. So parsing tex formulas and generate documentation is done automagically on each commit&push :)

                                  • Because all your formulas are changed into pictures in tex directory and README.md file use links to that pictures, you can even uninstall TeXify and all your old documentation will still works :). The tex directory and *.tex.md files will stay on repository so you have access to your original latex formulas and pictures (you can also safely store in tex directory your other documentation pictures "made by hand" - TeXify will not touch them).


                                  • You can use equations latex syntax directly in README.tex.md file (without loosing .md markdown syntax) which is very handy. Julii in his answer proposed to use special links (with formulas) to external service e.g . http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D which is good however has some drawbacks: the formulas in links are not easy (handy) to read and update, and if there will be some problem with that third-party service your old documentation will stop work... In TeXify your old documentation will works always even if you uninstall that plugin (because all your pictures generated from latex formulas are stay in repo in tex directory).

                                  • The Yuchao Jiang in his answer, proposed to use Jupyter Notebook which is also nice however have som drawbacks: you cannot use formulas directly in README.md file, you need to make link there to other file *.ipynb in your repo which contains latex (MathJax) formulas. The file *.ipynb format is JSON which is not handy to maintain (e.g. Gist don't show detailed error with line number in *.ipynb file when you forgot to put comma in proper place...).


                                  Here is link to some of my repo where I use TeXify for which documentation was generated from README.tex.md file.






                                  share|improve this answer


























                                  • Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                    – Royi
                                    Jan 16 at 10:23











                                  • @Royi I don't know

                                    – Kamil Kiełczewski
                                    Jan 16 at 10:50
















                                  3














                                  I test some solution proposed by others and I would like to recommend TeXify created and proposed in comment by agurodriguez and further described by Tom Hale - I would like develop his answer and give some reason why this is very good solution:




                                  • TeXify is wrapper of Readme2Tex (mention in Lee answer). To use Readme2Tex you must install a lot of software in your local machine (python, latex, ...) - but TeXify is github plugin so you don't need to install anything in your local machine - you only need to online installation that plugin in you github account by pressing one button and choose repositories for which TeXify will have read/write access to parse your tex formulas and generate pictures.

                                  • When in your repository you create or update *.tex.md file, the TeXify will detect changes and generate *.md file where latex formulas will be exchanged by its pictures saved in tex directory in your repo. So if you create README.tex.md file then TeXify will generate README.md with pictures instead tex formulas. So parsing tex formulas and generate documentation is done automagically on each commit&push :)

                                  • Because all your formulas are changed into pictures in tex directory and README.md file use links to that pictures, you can even uninstall TeXify and all your old documentation will still works :). The tex directory and *.tex.md files will stay on repository so you have access to your original latex formulas and pictures (you can also safely store in tex directory your other documentation pictures "made by hand" - TeXify will not touch them).


                                  • You can use equations latex syntax directly in README.tex.md file (without loosing .md markdown syntax) which is very handy. Julii in his answer proposed to use special links (with formulas) to external service e.g . http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D which is good however has some drawbacks: the formulas in links are not easy (handy) to read and update, and if there will be some problem with that third-party service your old documentation will stop work... In TeXify your old documentation will works always even if you uninstall that plugin (because all your pictures generated from latex formulas are stay in repo in tex directory).

                                  • The Yuchao Jiang in his answer, proposed to use Jupyter Notebook which is also nice however have som drawbacks: you cannot use formulas directly in README.md file, you need to make link there to other file *.ipynb in your repo which contains latex (MathJax) formulas. The file *.ipynb format is JSON which is not handy to maintain (e.g. Gist don't show detailed error with line number in *.ipynb file when you forgot to put comma in proper place...).


                                  Here is link to some of my repo where I use TeXify for which documentation was generated from README.tex.md file.






                                  share|improve this answer


























                                  • Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                    – Royi
                                    Jan 16 at 10:23











                                  • @Royi I don't know

                                    – Kamil Kiełczewski
                                    Jan 16 at 10:50














                                  3












                                  3








                                  3







                                  I test some solution proposed by others and I would like to recommend TeXify created and proposed in comment by agurodriguez and further described by Tom Hale - I would like develop his answer and give some reason why this is very good solution:




                                  • TeXify is wrapper of Readme2Tex (mention in Lee answer). To use Readme2Tex you must install a lot of software in your local machine (python, latex, ...) - but TeXify is github plugin so you don't need to install anything in your local machine - you only need to online installation that plugin in you github account by pressing one button and choose repositories for which TeXify will have read/write access to parse your tex formulas and generate pictures.

                                  • When in your repository you create or update *.tex.md file, the TeXify will detect changes and generate *.md file where latex formulas will be exchanged by its pictures saved in tex directory in your repo. So if you create README.tex.md file then TeXify will generate README.md with pictures instead tex formulas. So parsing tex formulas and generate documentation is done automagically on each commit&push :)

                                  • Because all your formulas are changed into pictures in tex directory and README.md file use links to that pictures, you can even uninstall TeXify and all your old documentation will still works :). The tex directory and *.tex.md files will stay on repository so you have access to your original latex formulas and pictures (you can also safely store in tex directory your other documentation pictures "made by hand" - TeXify will not touch them).


                                  • You can use equations latex syntax directly in README.tex.md file (without loosing .md markdown syntax) which is very handy. Julii in his answer proposed to use special links (with formulas) to external service e.g . http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D which is good however has some drawbacks: the formulas in links are not easy (handy) to read and update, and if there will be some problem with that third-party service your old documentation will stop work... In TeXify your old documentation will works always even if you uninstall that plugin (because all your pictures generated from latex formulas are stay in repo in tex directory).

                                  • The Yuchao Jiang in his answer, proposed to use Jupyter Notebook which is also nice however have som drawbacks: you cannot use formulas directly in README.md file, you need to make link there to other file *.ipynb in your repo which contains latex (MathJax) formulas. The file *.ipynb format is JSON which is not handy to maintain (e.g. Gist don't show detailed error with line number in *.ipynb file when you forgot to put comma in proper place...).


                                  Here is link to some of my repo where I use TeXify for which documentation was generated from README.tex.md file.






                                  share|improve this answer















                                  I test some solution proposed by others and I would like to recommend TeXify created and proposed in comment by agurodriguez and further described by Tom Hale - I would like develop his answer and give some reason why this is very good solution:




                                  • TeXify is wrapper of Readme2Tex (mention in Lee answer). To use Readme2Tex you must install a lot of software in your local machine (python, latex, ...) - but TeXify is github plugin so you don't need to install anything in your local machine - you only need to online installation that plugin in you github account by pressing one button and choose repositories for which TeXify will have read/write access to parse your tex formulas and generate pictures.

                                  • When in your repository you create or update *.tex.md file, the TeXify will detect changes and generate *.md file where latex formulas will be exchanged by its pictures saved in tex directory in your repo. So if you create README.tex.md file then TeXify will generate README.md with pictures instead tex formulas. So parsing tex formulas and generate documentation is done automagically on each commit&push :)

                                  • Because all your formulas are changed into pictures in tex directory and README.md file use links to that pictures, you can even uninstall TeXify and all your old documentation will still works :). The tex directory and *.tex.md files will stay on repository so you have access to your original latex formulas and pictures (you can also safely store in tex directory your other documentation pictures "made by hand" - TeXify will not touch them).


                                  • You can use equations latex syntax directly in README.tex.md file (without loosing .md markdown syntax) which is very handy. Julii in his answer proposed to use special links (with formulas) to external service e.g . http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D which is good however has some drawbacks: the formulas in links are not easy (handy) to read and update, and if there will be some problem with that third-party service your old documentation will stop work... In TeXify your old documentation will works always even if you uninstall that plugin (because all your pictures generated from latex formulas are stay in repo in tex directory).

                                  • The Yuchao Jiang in his answer, proposed to use Jupyter Notebook which is also nice however have som drawbacks: you cannot use formulas directly in README.md file, you need to make link there to other file *.ipynb in your repo which contains latex (MathJax) formulas. The file *.ipynb format is JSON which is not handy to maintain (e.g. Gist don't show detailed error with line number in *.ipynb file when you forgot to put comma in proper place...).


                                  Here is link to some of my repo where I use TeXify for which documentation was generated from README.tex.md file.







                                  share|improve this answer














                                  share|improve this answer



                                  share|improve this answer








                                  edited yesterday

























                                  answered Dec 30 '18 at 20:19









                                  Kamil KiełczewskiKamil Kiełczewski

                                  11.7k86894




                                  11.7k86894













                                  • Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                    – Royi
                                    Jan 16 at 10:23











                                  • @Royi I don't know

                                    – Kamil Kiełczewski
                                    Jan 16 at 10:50



















                                  • Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                    – Royi
                                    Jan 16 at 10:23











                                  • @Royi I don't know

                                    – Kamil Kiełczewski
                                    Jan 16 at 10:50

















                                  Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                  – Royi
                                  Jan 16 at 10:23





                                  Is there something like NBViewer for MarkDown files? Namely a service which you give him a URL of MarkDown file and it will show output with MathJax Support? There are many editors, but I couldn't find viewer.

                                  – Royi
                                  Jan 16 at 10:23













                                  @Royi I don't know

                                  – Kamil Kiełczewski
                                  Jan 16 at 10:50





                                  @Royi I don't know

                                  – Kamil Kiełczewski
                                  Jan 16 at 10:50











                                  1














                                  I upload repositories with equations to Gitlab because it has native support for LaTeX in .md files:



                                  ```math
                                  SE = frac{sigma}{sqrt{n}}
                                  ```


                                  The syntax for inline latex is $`sqrt{2}`$.



                                  Gitlab renders equations with JavaScript in the browser instead of showing images, which improves the quality of equations.



                                  More info here.



                                  Let's hope Github will implement this as well in the future.






                                  share|improve this answer






























                                    1














                                    I upload repositories with equations to Gitlab because it has native support for LaTeX in .md files:



                                    ```math
                                    SE = frac{sigma}{sqrt{n}}
                                    ```


                                    The syntax for inline latex is $`sqrt{2}`$.



                                    Gitlab renders equations with JavaScript in the browser instead of showing images, which improves the quality of equations.



                                    More info here.



                                    Let's hope Github will implement this as well in the future.






                                    share|improve this answer




























                                      1












                                      1








                                      1







                                      I upload repositories with equations to Gitlab because it has native support for LaTeX in .md files:



                                      ```math
                                      SE = frac{sigma}{sqrt{n}}
                                      ```


                                      The syntax for inline latex is $`sqrt{2}`$.



                                      Gitlab renders equations with JavaScript in the browser instead of showing images, which improves the quality of equations.



                                      More info here.



                                      Let's hope Github will implement this as well in the future.






                                      share|improve this answer















                                      I upload repositories with equations to Gitlab because it has native support for LaTeX in .md files:



                                      ```math
                                      SE = frac{sigma}{sqrt{n}}
                                      ```


                                      The syntax for inline latex is $`sqrt{2}`$.



                                      Gitlab renders equations with JavaScript in the browser instead of showing images, which improves the quality of equations.



                                      More info here.



                                      Let's hope Github will implement this as well in the future.







                                      share|improve this answer














                                      share|improve this answer



                                      share|improve this answer








                                      edited Jan 15 at 1:22

























                                      answered Jan 15 at 1:17









                                      EvgeniiEvgenii

                                      21.3k20110141




                                      21.3k20110141






























                                          draft saved

                                          draft discarded




















































                                          Thanks for contributing an answer to Stack Overflow!


                                          • Please be sure to answer the question. Provide details and share your research!

                                          But avoid



                                          • Asking for help, clarification, or responding to other answers.

                                          • Making statements based on opinion; back them up with references or personal experience.


                                          To learn more, see our tips on writing great answers.




                                          draft saved


                                          draft discarded














                                          StackExchange.ready(
                                          function () {
                                          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f35498525%2flatex-rendering-in-readme-md-on-github%23new-answer', 'question_page');
                                          }
                                          );

                                          Post as a guest















                                          Required, but never shown





















































                                          Required, but never shown














                                          Required, but never shown












                                          Required, but never shown







                                          Required, but never shown

































                                          Required, but never shown














                                          Required, but never shown












                                          Required, but never shown







                                          Required, but never shown







                                          Popular posts from this blog

                                          Mossoró

                                          Error while reading .h5 file using the rhdf5 package in R

                                          Pushsharp Apns notification error: 'InvalidToken'