Need help with markdown-themeable-pdf?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

cakebake
130 Stars 35 Forks 136 Commits 0 Opened issues

Description

ARCHIVED. NOT MAINTAINED. Themeable Markdown Converter (Print to PDF, HTML, JPEG or PNG)

Services available

!
?

Need anything else?

Contributors list

# 269,354
atom-ed...
Atom
atom-pa...
HTML
129 commits
# 67,107
gRPC
multi-c...
stringi...
TeX
1 commit
# 246,776
CSS
HTML
oauth2
atom-ed...
1 commit

This project is archived because the owner no longer uses the Atom Editor.

It would be very good to find a new owner for this project, who will take care of updating and expanding the Atom package. A new version based on Chrome Headless has already been prepared in a feature branch.

markdown-themeable-pdf.png

Themeable markdown converter (Print to PDF, HTML, JPEG or PNG)

Version Total Downloads License Dependencies

This Atom package converts / prints / exports your markdown file simple and pretty to
PDF
,
HTML
,
JPEG
or
PNG
format.

The package was created at the beginning to help in the daily work with manuals for customers. Many people are not familiar with Markdown and they will now receive a well-formatted PDF from their developers. Important here is that the document looks good and professional. This Atom package tries to ask about this task.

Installation

Search in atom under Settings View -> Install -> Packages the package

markdown-themeable-pdf
and start the installation.

Usage

The PDF can be generated in various ways:

  • Right-click in the editor area when a file is opened and select
    Markdown to PDF
    or
  • Right-click on a markdown file in Tree-View and select
    Markdown to PDF
    or
  • Press
    ctrl-shift-E
    (E = Export) in the editor area when a file is opened

Page breaks

You can start any time a new PDF page with typing Snippet/Shortcode

page-break
in your markdown editor. So you can prevent such ugly breaks in lists or other contiguous areas.

Custom CSS

The package creates a CSS file

~/.atom/markdown-themeable-pdf/styles.css
in your atom configuration directory. You can use this file to customize everything. If you want to change the path, you can change it in the package settings. Alternatively, you can define with
project-path/markdown-themeable-pdf/styles.css
for each project its own CSS.

Tip: Export your markdown as HTML to inspect it in your favorite browser. After CSS changes you must not restart atom.

Custom header & Custom footer

The pdf document can be decorated with your own header and footer. This can be flexibly adapted to JavaScript files. Each of these files represents a node.js module, which returns an object with two required properties

height
and
contents
. After you have made any changes you need to reload or restart atom.

To customize the document header, open

~/.atom/markdown-themeable-pdf/header.js
(you can change this path in the package settings) and change it to your needs:
// EXAMPLE
module.exports = function () {
    return {
        height: '2cm',
        contents: '
Created by Logo markdown-themeable-pdf
' }; };

To customize the document footer, open

~/.atom/markdown-themeable-pdf/footer.js
(you can change this path in the package settings) and change it to your needs:
// EXAMPLE
module.exports = function () {
    var dateFormat = function () {
        return (new Date()).toLocaleDateString('en-US', {
            weekday: 'long',
            year: 'numeric',
            month: 'short',
            day: 'numeric',
            hour: '2-digit',
            minute: '2-digit'
        });
    };
    return {
        height: '1cm',
        contents: '
Page {{page}}/{{pages}}
© Copyright ' + dateFormat() + ' by COMPANYNAME
' }; };

Tip: Alternatively, you can define with

project-path/markdown-themeable-pdf/header.js
or
project-path/markdown-themeable-pdf/footer.js
for each project its own header and footer.

Example / Demo

See Demo.pdf - the PDF version of Demo.md.

DEMO

Todo

  • Fix: Open Markdown Preview with
    ctrl-shift-M
    , right-click in markdown-preview area and select
    Save As PDF
  • Better handling of long code lines
  • Font Awesome integration
  • Emojis
  • Inline Links (Anchors)

Known Issues

  • Table header glitches when a table starts directly on a new page

    When that happens, you can put in your markdown in front of the table an html code

    to prevent this.

Credits

Special thanks to ...

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.