• Packages
  • Themes
  • Documentation
  • Blog
  • Discuss
Sign in

commentariat

Commentariat is a dark syntax theme explicitly designed for writing papers, essays, academic articles, and others in [markdown](https://en.wikipedia.org/wiki/Markdown).
  • #syntax
  • #theme
  • #markdown
  • #academic
  • #citation
anthbrtn
0.2.0 449
1
  • Repo
  • Bugs
  • Versions
  • License
Flag as spam or malicious

commentariat: academic writing in markdown that lets you focus on the content

Commentariat is a dark syntax theme explicitly designed for writing papers, essays, academic articles, and others in markdown. Despite the maturity of Atom's theming framework, there are few options available for dark themes to those interested in using Atom as an academic toolkit, and I find that writing with darker backgrounds and lighter text makes it easier to focus on the task at hand. If you want a light theme, I highly recommend Pen-Paper-Coffee). The theme features a pastel-based color scheme for a decent amount of contrast while writing the syntactic elements of markdown. The colors are mapped to a variety of different elements for differentiation, and the end result is being able to see each independent change or addition to your own plain text writing without the contrast between each element causing a headache, obviously important to writing the types of long documents characteristic of academic writing.
For an effective and seamless academic workflow writing in markdown in atom, I suggest the following extensions:

  1. For making citations an incredibly easier workflow, I recommend installing autocomplete-bibtex. I've found that other solutions for citations are not nearly as seamless (i.e. the Zotero citation picker plugins available). Having autocomplete-bibtex installed alongside the Better BiBTeX plugin for Zotero (and exporting an automatically-updating .bibtex keyfile) allows you to hit the @ symbol in any markdown file and fill in any citation very, very easily.
  2. The other game-changer is markdown-footnote. This allows you to hit a keyboard shortcut and immediately add a footnote to markdown documents. The key feature that it has over other markdown footnote plugins is the keybinding to return to where you plugged in the footnote back in the document---making for a seamless workflow when it comes to footnotes and citations together with autocomplete-bibtex.
  3. Zen for distraction-free writing. It blows the current writing window up to full screen, letting you dive in to whatever piece requires your focused attention.
  4. Advanced Open File is much more effective than atom's built-in file browsing utilities, and allows you to consult lists of notes or open outline documents that will help you with your writing.
  5. If you want to really superpower your academic project frameworks, I recommend installing project-manager.
  6. Markdown-table-editor makes the addition of tables easy. No more searching for 'csv to markdown converter' every time you have a csv that you need to convert into a table.
  7. wordcount does what it says.
  8. If you're feeling hardcore, linter plugins to improve your prose can be installed with linter-write-good and linter-proselint. They both require the basic linter framework. My caveat with suggesting these is the prescriptivism they push you towards---while they often catch things you should never use, like passive voice, they both also throw a fit at "weasel words" like "very" or any other qualifying adjective, which can suck the voice and life out of one's own writing style if you don't take their suggestions with a grain of salt. Proselint, especially, seems to think that the sparse style of Hemingway and others like him is the only correct style, when these decisions usually come down to preference.

Here's a screenshot of the markup backend for this post

img

This syntax theme started from an edit of monokai-solarized-dark.

I think this package is bad news.

Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.

  • Terms of Use
  • Privacy
  • Code of Conduct
  • Releases
  • FAQ
  • Contact
with by