Introduction

Writing with quarto

What this is for

So you want to write a document. Maybe you’ll share it on the web. Maybe you want a polished pdf. Maybe it’s a blog, research paper, book draft, or just a set of notes. You don’t want to think about typesetting details. You just want to throw your ideas in some plain text files and call make.

This is a starter template for using quarto, following the quarto Get Started. It seems to achieve a lot of what I was trying to do with my similar projects, markdown-memo and markdown-easy: make technical and scholarly writing easier and more productive.

This package makes it very easy to compile text taken in Markdown to valid xhtml or to a pdf via LaTeX. It can be used to make static webpages quickly, for example (this site):
https://rreece.github.io/quarto-example/

This same document compiled to a pdf can be found here:
https://rreece.github.io/quarto-example/Quarto-Example.pdf

See the README for quarto-example for how to compile this document to html or pdf.

See also

Quarto links:

• quarto.org - Guide - Reference
• quarto example using math
• quarto using bibtex and CSL
• quarto doc about github-pages
• example _quarto.yml

My projects:

• github.com/rreece/quarto-example
• github.com/rreece/markdown-easy
• github.com/rreece/markdown-memo

Pandoc links:

• pandoc.org/README.html
• commonmark.org
• github.com/lierdakil/pandoc-crossref

Other examples/blogs of writing with markdown:

• programminghistorian.org/lessons/sustainable-authorship-in-plain-text-using-pandoc-and-markdown
• kprussing.github.io/writing-with-markdown
• scholarlymarkdown.com
• github.com/simov/markdown-syntax
• markdownguide.org — source: github.com/mattcone/markdown-guide-book
• github.com/gabyx/Technical-Markdown
• mdBook
• MkDocs