I don't get it. Say I already know that I'll need some formulae in my document. Then the use case here seems to be, essentially, that I can write # Section Name instead of \section{Section Name} and that I can write *important stuff* instead of \emph{important stuff}. I can see that the markdown version is a little nicer on the eyes and keyboard, but only by a small margin. Now, if I write a document in latex I need…
Reach for Markdown, not LaTeX
151–160 of 184 posts
Re: Reach for Markdown, not LaTeX
#152I don't get it. Say I already know that I'll need some formulae in my document. Then the use case here seems to be, essentially, that I can write # Section Name instead of \section{Section Name} and that I can write *important stuff* instead of \emph{important stuff}. I can see that the markdown version is a little nicer on the eyes and keyboard, but only by a small margin. Now, if I write a document in latex I need…
Re: Reach for Markdown, not LaTeX
#153Earlier quoted context omitted.
Pandoc is awesome for things like tables or code blocks. Here is a table in pandoc markdown: | Header 1 | header 2 | |-|-| | Column 1 | Column 2 | Which is easy to write via emacs mode/vim plugin. Similar for code blocks. Plus this is extendable, I frequently use an extension that transforms DOT syntax into embedded graphs.
Tables are very complicated in LaTeX... but for a goodreason: tables are just hard . In your example: - Should the table appear flushed to the left? Centered in the page? flushed to the right? Full-width or only content-width? - What happens when Column 1 is long? Should the text wrap inside its own cell, overflow, or what? - Which row/column lines should appear? None? All of them? Only those that separate headers? T…
Re: Reach for Markdown, not LaTeX
#154Earlier quoted context omitted.
Web essays is definitely not the place to use professional typesetting tools. Browsers are simply incapable of doing professional quality typesetting of the type books have had since the 15th century because the output environment is too heterogeneous, unless you abandon html and render documents as SVG or PDF or something (I would not recommend doing that). Authoring tools won’t help you. On the web the best you can…
I've always been curious: Pretend I'm totally ignorant, and have no idea what need a typesetting tool fulfills. Someone who has used and been happy with Word / Open Office for years to write documents. What does LaTeX/InDesign solve for me, besides "nice looking math" that I'm not getting out of basic word processors? How do I know which one I need? I honestly have no clue. If I were to start writing a book tomorrow,…
InDesign is used when you need precise control of the output. For instance controlling exactly how figures are placed, you might more advanced control of how text flows between boxes, etc. It also has tools for very precise control of how the type is set, how big space should there be between letters and words, how should the right edge of columns look, should there be different number of columns on different pages, etc.
Some of those things can be somewhat managed in Word, but you'll have to fight a lot of the automatic stuff, really not worth it if you are a full time design professional, much cheaper then to buy an expensive InDesign license.
Latex is pretty good at having sane defaults. This was a bigger issue back in the days when the defaults of Word were frankly terrible. Today it's to a large extent about style choice. If you publish in an area where Latex dominates, the Latex styling will make your document appear as more serious. Latex also generally uses a more advanced type setting engine, for example it might join "fi" with ligatures etc. This can also improve the look of the document.
Some people like the fact that you can manage Latex code as raw text. For instance using a VCS to manage version history. Word has some built in version management functionality, but it's quite clunky compared to Git.
Personally I gave up on using Latex after my first master thesis and tend to use Word. I get too caught up in the formatting when I use Latex. Maybe it's too much power to handle for me?
Re: Reach for Markdown, not LaTeX
#155Earlier quoted context omitted.
>Documentation is meant to be read by everyone, not make you feel good about being forced to write it. I think you missed the point you were trying to make here because nobody has any difficulty reading the PDFs rendered from latex.
Yes, but maintaining documentation in PDF is not. Half the people that manage our doc are non-programmers. They're not learning LaTeX. They're not editing raw PDFs while the other half of the team uses LaTeX.
Re: Reach for Markdown, not LaTeX
#156Earlier quoted context omitted.
I'd also add that while Markdown and LaTeX can do some of the same things, they're designed toward very different tasks. I've used both numerous times in my career, and I can't remember a case where it's been ambiguous which tool was more appropriate for the task. If it's going to be printed, you probably want LaTeX. If it's going to be rendered to a screen, you probably want Markdown. If it's going to be rendered to…
When you say "rendered to a screen", do you really mean "placed on a webpage"? PDFs generated by LaTeX are rendered to screen all the time. edit: Actually, I find that I completely agree with your point if "printed" is replaced by "shared in pdf format" and "rendered to screen" is replaced by "shared in plain text or HTML format".
Will the content be shown with fixed line lengths, or with responsive line lengths?
Re: Reach for Markdown, not LaTeX
#157Earlier quoted context omitted.
I just make the symbols shortcuts for the commands. So for instance ∑_{0≤n≤k}n² expands to \sum_{0\le n\le k} n^2.
Do you have a library of these substitutions available? Sounds like it could be useful.
Some of these are suboptimal. But you can just change them, and make your own.
Re: Reach for Markdown, not LaTeX
#158I don't get it. Say I already know that I'll need some formulae in my document. Then the use case here seems to be, essentially, that I can write # Section Name instead of \section{Section Name} and that I can write *important stuff* instead of \emph{important stuff}. I can see that the markdown version is a little nicer on the eyes and keyboard, but only by a small margin. Now, if I write a document in latex I need…
The markdown source is a great deal more readable -- all of those little substitutions that seem inconsequential individually add up to a lot less noise in your document source. Equations just pass through to LaTeX, so you write them the same. All of my floats started out using markdown syntax, which is really beneficial when drafting, since much harder to mess up a single line when cutting and pasting it around. In the end, I wanted finer control over how they looked, so I pasted the generated tex into my sources and worked from there.
My one caveat is, you absolutely must understand LaTeX first, or you will be in for a bad time. Pandoc + markdown + LaTeX is no substitute for understanding LaTeX, but it's a huge win if you're already familiar with LaTeX and you're tired of typing backslashes.
Finally, the recommendation to use article is unfortunate. Memoir will save you a lot of headaches.
Re: Reach for Markdown, not LaTeX
#159Earlier quoted context omitted.
Pandoc is awesome for things like tables or code blocks. Here is a table in pandoc markdown: | Header 1 | header 2 | |-|-| | Column 1 | Column 2 | Which is easy to write via emacs mode/vim plugin. Similar for code blocks. Plus this is extendable, I frequently use an extension that transforms DOT syntax into embedded graphs.
Thing is, if you're already looking to use e.g., Emacs, you'll be better off using org-mode instead of markdown. Same lightness of syntax, tens of times the functionality (including much better tables, which you can use directly from a TeX document, as well, via radio tables). Editing ascii tables with no editor support is painful. There's also some org functionality in vim plugins, though I've never used them, so I…
Re: Reach for Markdown, not LaTeX
#160Earlier quoted context omitted.
I'm a bit confused by this. As I see it, LaTeX can do everything that Markdown can before things get complicated. Where LaTeX does get complicated (e.g. when designing figures or drawings), Markdown doesn't offer any advantage or even any functionality. For composing simple documents or outlines and doing typesetting of equations, LaTeX has some boilerplate but it's really not that much.
LaTeX in my experience, is worse than markdown for one crucial use case: formatting code. Formatting large blocks of monospaced text (especially monospaced text that includes character sequences that can be interpreted as LaTeX commands) has always been kind of a chore. In markdown, on the other hand, it's as simple as enclosing the text between two sets of triple-backticks (```).
` is a three-key combination AND a dead key on non-US keyboards.