Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Use a specific markdown file to write proper formatted papers and articles.
JavaScript Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
test
README.md
configure
example.png
screen.default.css
screen.twocol.css

README.md

Markdown Papers 0.1

@dracoblue, @rmetzler

Abstract

The idea is to use a specific markdown file to write proper formatted papers and articles. It's still work in progress and only pre-alpha, but already looks quite nice.

Keywords

markdown, javascript, llncs

Example

You can use this README.md as source and generate a .html by using:

$ bin/markdown-papers README.md README.html

The output should look like that:

Example Output

Pre-Conditions

You need node.js, npm and the CMU Fonts (optional, will fallback to default serif font) installed.

node.js Dependencies

Use

$ ./configure

to automaticly resolve those by using npm.

Installation

It's quite simple to test the current version.

Get your self a copy and configure it with npm:

$ git clone git://github.com/DracoBlue/markdown-papers.git
$ cd markdown-papers
$ ./configure

Now, test it:

$ bin/markdown-papers README.md README.html

and it will generate the README.md as a nicely formatted one.

Command line option: --template

If you want to use a different template (located at lib/templates/*.html), you must use the --template option.

$ bin/markdown-papers --template twocol README.md README.html

This will convert the .md-File by using the lib/templates/twocol.html template. You could put your own templates into that folder to make them available for the markdown-papers script.

Rules for the .md-File

Even though this is still work in progress, here are the current rules for the document.

  1. Use # Title for the title of the Paper
  2. Every text after the title will be used as author and aligned in center.
  3. Use ### Abstract and ### Keywords to provide those sections with content.
  4. Every following ## Item will be added to the table of contents and is a section.

Very simple example:

# My Paper
Mr. Author

### Abstract
This is a short one!

### Keywords
example, markdown

## Introduction
And so on

## Conclusion
Awesome 

You can also use this README.md as example.

ToDo

  • clean up and document code
  • add print style sheet
  • generate .pdf files

Changelog

  • 2012/29/01
    • added MarkdownPaper#setTemplate(template_name), which loads templates/{template_name}.html.
    • renamed screen.css to screen.default.css
    • added test for template without abstract+keywords
    • added first test for twocol-layout
    • added command line option --template

License

markdown-papers is available under the terms of MIT License.

Something went wrong with that request. Please try again.