Right now i am searching for an alternative for writing academic reports (master thesis). in the past i have written such reports (bachelor final projects) with MS Word and it is NOT an enjoyable experience. Whereas latex is widely used for academic reports, i don't really want to learn something so complex only for academic reports, i want to learn something that also can be used for general usage (documentation, blog writing, etc).<p>Here i found out about restructuredtext and markdown as a markup language for documentation. After some reading i concluded that restructuredtext is more in tune with what i am trying to accomplish e.g: it can be converted into latex if i want to incorporate bibliography from latex<p>What are your experiences on using markup language for writing general or academic documents(using figures, tables, bibliography, etc)? do you have suggestions regarding this topic?<p>PS:
I mainly using linux<p>amd
Here are some applications for writing markup language that i found:<p>https://notex.ch/ (rst, markup, latex) -- it seems to be made with GWT<p>http://rst.ninjs.org/ (rst)<p>https://github.com/github/markup (many)<p>http://sourceforge.net/projects/retext/<p>edit:<p>i agree with the expression "when you have a hammer, you see every problem as a nail" as stated by commenters.<p>but right now i am not proficient enough with a tool to switch or compare with another one.<p>some commenter suggest that i really invest in learning latex. i was starting to learn latex from wikipedia wikibook when i got intimidated by it and went to searching for alternatives.<p>based on the commenters some ways/applications to ease this learning are:<p>1. lyx<p>2. www.writelatex.com<p>3. using latex templates<p>4. scrivener<p>any other suggestions?
The first thing you need to know about is <a href="http://johnmacfarlane.net/pandoc/" rel="nofollow">http://johnmacfarlane.net/pandoc/</a> which is a fantastic tool.<p>So I would say that it might be worth reconsidering LaTeX because it has <a href="http://www.bibtex.org/" rel="nofollow">http://www.bibtex.org/</a> which is excellent for academic papers. The investment to get competent with LaTeX is certainly several hours, but it pays itself back quickly. See <a href="http://en.wikibooks.org/wiki/LaTeX" rel="nofollow">http://en.wikibooks.org/wiki/LaTeX</a> for a good learning resource.<p>For myself, I mainly use <a href="http://orgmode.org/" rel="nofollow">http://orgmode.org/</a> for emacs. This can export as LaTeX, and from there to any of the vast multitude of formats that LaTeX can be converted to. However, if you're not willing to learn LaTeX, then you're probably not willing to learn emacs either: where LaTeX is a matter of hours to learn competently, emacs takes weeks.<p>I used Markdown to write the bulk of my text for a while, but I found it didn't scale very well to large documents. It is great for blog posts and the like.
Maybe <a href="https://www.writelatex.com/" rel="nofollow">https://www.writelatex.com/</a> can help you become familiar with LaTeX? I'm not huge into type-setting myself but there are numerous text editors and markup formats that can export to LaTeX. The bonus is that you can script most of the workflow and cargo-cult what you need to get the document working until you properly figure things out.
Have you considered LyX? Designed for people with a problem like yours - wanting the benefit of TeX output without the effort needed to learn something new. It's also a pretty good structure oriented (rather than WYSIWYG) editor.
You may not want to use the same tools to write academic reports and blog posts. It's best explained by the popular programming quote that "when you have a hammer, you see every problem as a nail."<p>LaTeX can get hard, but templates lower the learning curve. Google "latex report templates," learn how to compile them, play with them. Even if it's harder the first day, it will be a lot more useful in the long term.<p>The learning curve is not a fair excuse not to try it. If you try it, build things with it, and don't like it, you'll know what you're not missing.
Look if anyone in your institution has created a dissertation template for LaTeX, or if you can use one [from elsewhere](<a href="https://github.com/briandealwis/ubcdiss" rel="nofollow">https://github.com/briandealwis/ubcdiss</a>). I personally found the formatting to be the hardest part, not the actual writing, especially since you can find helpers for various text editors, like LaTeXTools for Sublime etc.<p>As pointed out elsewhere in this thread, don't make your hammer solve all of the problems.
As other commenters have mentioned, Pandoc[1] is an incredibly useful tool for converting documents between formats. I do not, however, think that its usefulness in a solution to your specific problem has been framed clearly enough. It uses a version of the markdown syntax which is slightly-modified to ease writing of lengthier or academic documents. For example, a citation to a BibTeX bibiliography (usually performed in LaTeX by typing `\cite{McElroy-2000}`) is written `@McElroy-2000`, headers can be tagged to simplify internal references, and actual LaTeX commands can be called if you need them. Since the changes from standard markdown are minimal, you can write using any of the many markdown editors which are available.<p>As to my particular setup, I write Pandoc markdown in Vim using a plugin which I wrote for that purpose.[2] Nothing fancy, mind you, just light syntax highlighting, some keyboard shortcuts for (1) exporting to html or pdf (via-LaTeX) and (2) jumping between headers, and document folding, the latter of which is especially useful for outlining and organizing lengthy documents.<p>[1]: <a href="http://johnmacfarlane.net/pandoc/" rel="nofollow">http://johnmacfarlane.net/pandoc/</a><p>[2]: <a href="https://github.com/shushcat/minimd" rel="nofollow">https://github.com/shushcat/minimd</a>
Lyx. Full stop.<p>I've used it for two papers for arXiv, with equations and tables. It can write any math formula you can write on paper. You don't need to learn Latex <i>at all</i> to use it. It's very clear and intuitive. It's not WYSIWIG, but it's clear what you're going to get, and what you need to do on-screen to get what you want.<p>And,if you're on Linux, you should be able to get it running with no sweat.
Markdown and RST is what people generally use for documentation and blog writing.<p>However, LaTeX has features designed for academic writing (e.g. you can have references to sections / bibliography entries, so when you insert or delete new ones, the numbers in the text are updated automatically.)<p>You don't mention what subject your thesis is in, but if it involves mathematical notation, you will likely have a lot more work and poorer results if you use anything but LaTeX.<p>Specifically related to the question of using LaTeX's mathematical typesetting capabilities in documentation or webpages, MathJax [1] is a popular solution. The Python-based static blog generator Nikola [2] has support for MathJax.<p>As for being intimidated by LaTeX, and being too unfamiliar with alternatives to make a comparison, I suggest spending a day or so trying to write a small part of your report in LaTeX, then deciding after you've used it.<p>[1] <a href="http://www.mathjax.org/" rel="nofollow">http://www.mathjax.org/</a><p>[2] <a href="http://getnikola.com/" rel="nofollow">http://getnikola.com/</a>
Thank you everyone for the suggestions and insights.
After contemplating with the choices i have decided to go through with restructuredtext, and pickup latex bit-by-bit to incorporate scientific parts (it turns out you can do some inline latex in restructuredtext).<p>here are some factors that drive my decision:<p>- i can start writing content right away without much initial learning<p>- rst can be read/revised by my other peers with more ease than full blown latex document.<p>- i can use latex parts (equations, typesetting, etc) inline with rst, and i can learn latex bit-by-bit on the way<p>- there some libraries/program that can make attractive presentations using rst (<a href="http://regebro.github.io/hovercraft/#/step-1" rel="nofollow">http://regebro.github.io/hovercraft/#/step-1</a>)<p>so i will use rst and learn latex on the way.
I'm also an academic. I use Scrivener, then pop it into LaTeX. Scrivener has a non-commercial version for Linux. It's not fully featured, but it still does a good job. You have to download it from their forum: <a href="http://www.literatureandlatte.com/forum/viewforum.php?f=33&sid=40d9c854a6f68a5b81399c30098eec7f" rel="nofollow">http://www.literatureandlatte.com/forum/viewforum.php?f=33&s...</a><p>Learning LaTeX is absolutely worth the time and effort. I realize it's not the easiest thing to learn, but it's invaluable for keeping track of citations, simple typesetting, and rendering equations. It is not, however, worth using for making slideshows or posters.
1. Draft in Scrivener.
2. Export to rtf.
3. Open the file in Open Office.
4. Export to LaTex.
5. Typeset pdf.<p>You can also export directly from Scrivener to LaTex, but a thesis is going to require a good deal of back and forth and revisions before it is ready for typesetting.<p>If you don't want to have a typeset final product, you can write in Scrivener and export to many different formats. If you want to write using Markdown syntax, you can do so in Scrivener as well. It's a terrific program.
Word with Zotero makes for a rather painless thesis writing experience.<p>Just remember to mark headlines as headings, and don't just change the font size of your headlines. It's easy to insert references to formulas, figures and graphs.<p>LibreOffice + Zotero makes for the some fairly painless bibliography, table of content, internal figure referencing.<p>If you need to build advanced graphs from large dataset, there is no painless way about it, but LaTex is in no way more difficult than the other options.
Check out asciidoc, it is quite mature. You can start using it quickly, but it's very full-featured and has a supportive community. Can generate text, HTML, Docbook XML, PDF output. Generates nice looking output, customizable, etc.<p>It's like markdown but more mature and scales to large documents.<p><a href="http://www.methods.co.nz/asciidoc/" rel="nofollow">http://www.methods.co.nz/asciidoc/</a>
i would probably try using pandoc's markdown <a href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown" rel="nofollow">http://johnmacfarlane.net/pandoc/README.html#pandocs-markdow...</a> and then generating latex from that. but that's because (imho) markdown is easy to edit / read. getting latex output any different from the default is going to involve "learning latex" i suspect.<p>pandoc is written in haskell and available on linux. for opensuse you can install it from <a href="http://software.opensuse.org/search" rel="nofollow">http://software.opensuse.org/search</a><p>[i wrote my own thesis in latex, but that was many years ago. another advantage of starting in markdown is that it's easier to get to other formats, like putting your thesis on the web.]
We're beta-testing an online editor for technical documents, if you want to join we would be glad to have you (email/url in my profile).
If you'd prefer a more DIY solution, in addition to LaTeX you should also check out asciidoc, it seems to support a lot of what you're after.
If you want to go with reStructuredText, I highly suggest using Leo[1] -- it uses rST heavily internally, and provides fantastic tools for working with it.<p>[1]: <a href="http://leoeditor.com/" rel="nofollow">http://leoeditor.com/</a>