[BlindMath] markdown

Sun Aug 9 21:32:16 UTC 2020

Yes, my typo in the original was picked up and spat the first warning.

The suggestion to remove the offending } works, as would adding the corresponding { to enclose the upper end of the summation indicator. Snippet is ^{n}  
Both options work, but...

I seem to automatically have mathjax rendering as part of my workflow. You will need to add a small bit on the end of your command: --mathjax 

The missing title doesn't really matter for the purposes of testing. When you get to writing up proper documents, then you'd be adding all manner of content, including a title, author etc. Add the following three lines to the top of the markdown file:
---
title: "testing"
---

I have to admit that I wasn't planning on conducting a tutorial via this list which I suspect is out of line. I use a particular flavour/extension of markdown in conjunction with R. People just wanting to make accessible documents do not need my workflow, but finding a suitable suggestion that suits the beginner is taking some time. I do not suggest a software solution unless I am prepared to deal with the potential flood of messages wanting guidance on that software. That means I suggest tools I use frequently, and/or after thorough testing of software that is new to me.

Jonathan

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Volodymyr Dorozhinsky via BlindMath
Sent: Monday, 10 August 2020 8:06 AM
To: blindmath at nfbnet.org
Cc: Volodymyr Dorozhinsky <dorozhinsky at ukr.net>
Subject: Re: [BlindMath] markdown

Hello Eric,

it seems in Your latex formula You have extra } which is not needed. 
Please compare...

Original:

$$\mu =
\frac{1}{n} \sum_{i=1}^n}{x_i}$$

Fixed:

$$\mu =
\frac{1}{n} \sum_{i=1}^n{x_i}$$

Best regards
Volodymyr

On 8/9/20 9:47 PM, Eric Mandell via BlindMath wrote:
> Hi Jonathan,
>
> This was incredibly helpful. Thank you. I would love to see the 
> continuation of this tutorial and other tutorials like it if possible.
>
> When I ran the pandoc code in windows command line I got a couple 
> warnings. The first warning appears to refer to the latex code $$\mu = 
> \frac{1}{n} \sum_{i=1}^n}{x_i}$$ I am not sure about the second 
> warning. The HTML document was created and looks fine except that it 
> didn't turn the latex code $$\mu = \frac{1}{n} \sum_{i=1}^n}{x_i}$$ 
> into math. I'm new to all this so I'm not sure how to fix the issue.
>
> Here are the warnings I got:
> [WARNING] Could not convert TeX math '\mu = \frac{1}{n} 
> \sum_{i=1}^n}{x_i}', rendering as TeX: {1}{n} \sum_{i=1}^n}{x i} 
> unexpected '}'
>
> WARNING] This document format requires a nonempty <title> element.
>    Defaulting to 'testmarkdown' as the title.
>    To specify a title, use 'title' in metadata or --metadata title="...".
>
> Any guidance would be appreciated. Thanks again for taking the time to 
> post this tutorial.
>
> Eric
>
> On 7/29/20, Emily Schlenker via BlindMath <blindmath at nfbnet.org> wrote:
>> This is wonderful! Thank you so much.
>>
>> Sent from my iPhone
>>
>>> On Jul 29, 2020, at 10:50 PM, Godfrey, Jonathan via BlindMath 
>>> <blindmath at nfbnet.org> wrote:
>>>
>>> Hello Rmana and anyone else interested in markdown,
>>>
>>>
>>>
>>> I decided to write some thoughts here in a new thread because I 
>>> think there are a bunch of people who don't know, but should learn, 
>>> how easy it is to work with markdown.
>>>
>>>
>>>
>>> First: markdown files are plain text, editable in any text editor, 
>>> even Notepad in Windows. The raw files are therefore very readable in braille.
>>> I choose to use uncontracted 8 dot braille output because I am 
>>> generally needing to see the range of characters used in coding that 
>>> are seldom used in literary work, including {} and \ for example.
>>>
>>>
>>>
>>> Second. The text files do not need to be given an extension of *.md 
>>> but this is strongly advisable. It will make conversion easier. You 
>>> may need to watch that an extra *.txt doesn't get added to your filename.
>>>
>>>
>>>
>>> Third: conversion to HTML is done using pandoc. Even if people are 
>>> not going to use markdown, getting hold of pandoc for conversion 
>>> among other formats is a good idea. We'll worry about that stuff 
>>> later. Use of the right editor can make conversion faster; we all 
>>> have our favourites. In general though, people will write a command line that is of the form:
>>> "pandoc -s file.md -o file.html" which says take my source file 
>>> called "file.md" and make the output file "file.html". Even if the 
>>> editor has a conversion tool linked to it, this command line is what 
>>> gets done behind the scenes.
>>>
>>>
>>>
>>>
>>>
>>> So, that's the process. What's hard about that? Well the command 
>>> line is what throws people the most. I hope other people will share 
>>> which editors they use and the way they process the markdown in a 
>>> more automated fashion.
>>>
>>>
>>>
>>> Then, we need to write a few things down. If I gave you a text file 
>>> and you read the following five lines (count carefully, including blank lines)
>>>   <starts>
>>>
>>> ## Introduction
>>>
>>>
>>>
>>> Let $\mu$ be the **population mean** of a variable.
>>>
>>> We calculate this by summing the observations and dividing by the 
>>> number of observations
>>>
>>> $$\mu = \frac{1}{n} \sum_{i=1}^n}{x_i}$$
>>>
>>> <ends>
>>>
>>>
>>>
>>>
>>>
>>> Back to me: I've used plain text characters to do some formatting, 
>>> and LaTeX users will see the familiar construct for an inline 
>>> mathematical element as well as an equation that will be on its own 
>>> line in the document. The use of the number signs (pound or hash to 
>>> some people) suggests some sort of heading based on the way it 
>>> appears; in fact this will be put as a <h2> element in HTML which 
>>> means heading level 2. It looks like I've tried to emphasize the 
>>> "population mean" using some stars/asterisks; two of them means 
>>> bold, only one would have been italic, and in a fit of logic, 3 means bold italic!
>>>
>>>
>>>
>>> Some other features that are less easily demonstrated in an email 
>>> typed in Outlook include how we make bulleted or numbered lists, and 
>>> how we manage indenting to make lists within lists.
>>>
>>>
>>>
>>> You have almost certainly read HTML content that was created from 
>>> markdown because it is used in blogging sites and numerous 
>>> documentation projects for software where there are code 
>>> demonstrations. For example, if I type `mean()` in a document, I am telling my students that the command "mean"
>>> is used. I put the () there to make a point, but the use of the 
>>> backticks (also known as accent grave) turns that element into typewriter font.
>>>
>>>
>>>
>>> I hope you've had enough of a taste to want to know how to get 
>>> pandoc and a useful editor to have a go for yourself.
>>>
>>>
>>>
>>> I'll fetch out some instructions for getting the simplest 
>>> installation going when time allows = not in the next two hours.
>>>
>>>
>>>
>>> Jonathan
>>> _______________________________________________
>>> BlindMath mailing list
>>> BlindMath at nfbnet.org
>>> http://nfbnet.org/mailman/listinfo/blindmath_nfbnet.org
>>> To unsubscribe, change your list options or get your account info 
>>> for
>>> BlindMath:
>>> http://nfbnet.org/mailman/options/blindmath_nfbnet.org/eschlenker%40
>>> cox.net
>>> BlindMath Gems can be found at
>>> <http://www.blindscience.org/blindmath-gems-home>
>>
>> _______________________________________________
>> BlindMath mailing list
>> BlindMath at nfbnet.org
>> http://nfbnet.org/mailman/listinfo/blindmath_nfbnet.org
>> To unsubscribe, change your list options or get your account info for
>> BlindMath:
>> http://nfbnet.org/mailman/options/blindmath_nfbnet.org/emandell2%40gm
>> ail.com
>> BlindMath Gems can be found at
>> <http://www.blindscience.org/blindmath-gems-home>
>>
> _______________________________________________
> BlindMath mailing list
> BlindMath at nfbnet.org
> http://nfbnet.org/mailman/listinfo/blindmath_nfbnet.org
> To unsubscribe, change your list options or get your account info for BlindMath:
> http://nfbnet.org/mailman/options/blindmath_nfbnet.org/dorozhinsky%40u
> kr.net BlindMath Gems can be found at 
> <http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
BlindMath mailing list
BlindMath at nfbnet.org
http://nfbnet.org/mailman/listinfo/blindmath_nfbnet.org
To unsubscribe, change your list options or get your account info for BlindMath:
http://nfbnet.org/mailman/options/blindmath_nfbnet.org/a.j.godfrey%40massey.ac.nz
BlindMath Gems can be found at <http://www.blindscience.org/blindmath-gems-home>