Format: plain text

• In computer science, plain text refers to text that consists exclusively of letters, spaces, numbers and punctuation marks.
• Text that is formatted (bold, italic, underlined, sub- and superscript as well as tables and images) is not plain text.
• A number of formatting characters such as carriage return / line feed and tab stop do occur in plain text.

Advantages of plain text

1. Can be read by any computer
2. can be synchronized on all your devices
3. can be converted to virtually any other format (use [pandoc] (https://pandoc.org/))
4. is guaranteed to be legible in the future (meets the standards of long-term storage)
5. is easy to read and catalog
6. is a useful format for data mining
7. is an excellent version control format (use [git] (https://git-scm.com/))

Text editor

• an application with which unformatted digital text can be edited. That is also the big difference with a word processor, which aims to create formatted text.
• a necessary tool when writing for the web
• will help edit html, css, d3.js ... code
• examples of text ediors:
  • [Sublime Text] (https://www.sublimetext.com/) (with plugins marked, evernote, pandoc, git)
  • [Atom] (https://atom.io/)
  • [Notepad ++] (https://notepa-plus-plus.org/)

Markdown

• is not a language or program, just a convention to indicate semantic units in a text, with simple syntax:
  • [canonical specification] (https://daringfireball.net/projects/markdown/syntax)
  • [CommonMark Spec] (http://spec.commonmark.org/0.24)
• Markdown has become a de facto standard for online writing
• Writing in this way liberates the author from the tool - you can write with any editor
• A markdown file can serve as a mother file for a wide range of document formats: scientific articles, wikis, syllabi, blog posts ...
• get to know [Markdown] (https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)

Vertaaltypen Tekstvertaling Brontekst 2682 / 5000 Vertaalresultaten

Markdown applications

• content management systems such as wordpress and drupal have [markdown filters] (https://www.drupal.org/project/markdown)
• there is also the [markdown here extension] (https://github.com/adam-p/markdown-here) for browser and gmail
• [mailmate] (http://freron.com/) is an email client (Mac OS X) with support for markdown
• you can also work with an online markdown editor such as [stackedit] (https://stackedit.io/app) or Markable.in. A workflow with the first: ['A simple way to write, edit, and publish documentation online using Google Docs and Markdown'] (http://idratherbewriting.com/2014/02/25/a-simple-way-to- write-edit-and-publish-documentation-online-using-google-docs-and-markdown /))
• [coggle] (https://coggle.it/), create mind maps with markdown
• [trello] (https://trello.com/), project management
• [jupyter interactive notebooks] (http://jupyter.org/) understand markdown
• packages to generate static websites like [jekyll] (https://jekyllrb.com/) can very well be done with markdown input
• you can also work with an online markdown editor such as [stackedit] (https://stackedit.io/editor) or Markable.in. A workflow with the first: ['A simple way to write, edit, and publish documentation online using Google Docs and Markdown'] (http://idratherbewriting.com/2014/02/25/a-simple-way-to- write-edit-and-publish-documentation-online-using-google-docs-and-markdown /))
• [coggle] (https://coggle.it/), create mind maps with markdown
• [trello] (https://trello.com/), project management
• [interactive notebooks] (http://jupyter.org/) means markdown
• packages to generate static websites like [jekyll] (https://jekyllrb.com/) or [mkdocs] (http://www.mkdocs.org) work very well with markdown input
• turn your markdown file into a presentation with reveal.js
• download [from github] (https://github.com/hakimel/reveal.js), [here's the list of what you can do] (http://lab.hakim.se/reveal-js/#/) and here you read the [installation procedure] (https://github.com/hakimel/reveal.js#installation)
• download folder ! [] (http://hc.ulyssis.be/assets/20160223-nagare5.png)
• edit the title page of the presentation in the file index.html
• and link to your markdown file ! [] (http://hc.ulyssis.be/assets/20160223-nagare6.png)
• indicate slides in file ! [] (http://hc.ulyssis.be/assets/20160223-nagare7.png)
• view the result in your browser ! [] (http://hc.ulyssis.be/assets/20160223-nagare8.png)
• turn your markdown files into a static website
  • with [jekyll] (http://jekyllrb.com/) or [mkdocs] (http://www.mkdocs.org)
• [combine jekyll and reveal.js] (https://github.com/dploeger/jekyll-revealjs)

Pandoc

Swiss army knife for converting from one markup format to another.

• [pandoc.org] (https://pandoc.org/) ([Try online] (https://pandoc.org/try/))

Treat you source files as an authoritative version of your text, and you target files as disposable “print outs” that you can easily generate with Pandoc on the fly.

• CLI

$ pandoc -f html -t markdown http://informatiewijzer.be/module/schrijven_voor_het_web -o 20180216-mdtest.md

• convert to pdf via pandoc with display of
  • toc (table of contents)
  • footnotes
  • bibliographic references

$ pandoc -S -o writing_workflow.pdf writing_workflow.md -V geometry:margin=1in -N --toc --filter pandoc-citeproc