yhatt / marp

The site of classic Markdown presentation writer app

It's a time to migrate into Marp Next!

The publication of classic Marp app has ended.

Marp desktop app, a simple Markdown presentation writer, already had stopped maintenance since 2017. Today Marp team is focusing into Marp Next project, the brand-new presentation ecosystem for the future.

See more details in our blog post.

Why?

We had kept publishing app for stuck users that are thinking Marp Next is too complex.

But recently, we received a serious security report for outdated app. By opening a malicious Markdown, an attacker can execute arbitrary code through remote. We are responsible for saving users from malicious.

If you are currently using Marp app, please stop using as soon as possible and migrate into well-maintained Marp Next tools.

Marp Next tools

Marp Next is not complex! Simply you can just use either one if you want to create slide deck.

Marp for VS Code (Recommended)

Marp for VS Code, an extension for Visual Studio Code, is the best alternative for desktop app users. There are key features inherited from the classic Marp app.

• Live preview
• Export to PDF, HTML, and PPTX (via Marp CLI)
• Support built-in 3 themes and custom theme CSS

Marp CLI

Marp CLI is simple but powerful CLI converter from Marp Markdown into PDF, HTML, PPTX, and images. You can use it if you don't want GUI editor.

I also have an example repository to automate generating slide deck and serving through Marp CLI + Netlify or ZEIT Now.

Migrate Markdown

Marp Next is losing Markdown compatibility with classic app, but your slide would keep appearance as before just by some changes in most cases. Please see our blog post for details.

Thanks

Thanks for a lot of users / contributors of desktop app. Marp has changed my life as developer without doubt, and I've learned a lot from many feedbacks.

Now Marp Next project is evolving built on them. I hope you like it too.

---

— Yuki Hattori (@yhatt)

marp's Issues

Missing scroll sync in markdown mode

Markdown mode looks and works great (even better than in Github's Atom), still one thing missing is scroll sync.
Whenever I scroll either window the other stay still, it'll be great to have an option so preview always matches content in left window

Bug report

All I did was launch the app on Mac Os Ten Point Elven dot 5ive.

Looks like some kind of race condition:

A JavaScript error occurred in the main process

Uncaught Exception:
Error: Cannot create BrowserWindow before app is ready
    at Error (native)
    at /Users/sdegutis/Downloads/Marp.app/Contents/Resources/app.asar/js/classes/mds_window.js:1:1282
    at new e (/Users/sdegutis/Downloads/Marp.app/Contents/Resources/app.asar/js/classes/mds_window.js:1:2911)
    at EventEmitter.<anonymous> (/Users/sdegutis/Downloads/Marp.app/Contents/Resources/app.asar/js/main.js:1:994)
    at emitTwo (events.js:106:13)
    at EventEmitter.emit (events.js:191:7)

Feature Request: Footnotes

Would like to see support for Markdown Footnotes (as used on Wordpress and elsewhere, I believe based on Mulitmarkdown?). Something like this:

`Clicking this number¹ will lead you to a footnote.

Footnotes

1. Handy! Now click the return link to go back.` ↩

Export Powerpoint slides

This project looks absolutely fantastic. I'd be interested in contributing, and wanted to know more details about how it would interoperate with Powerpoint slides. At the very least, it seems very interesting to be able to export Powerpoint slides. Most organizations and conferences I know expect Powerpoint slides, and it'd be handy to send them to somebody who doesn't use Marp.

Is Marp's roadmap open to this?

UTF-8 encoding is buggy

It is not possible to save/open files with text using accents, the encoding is almost always wrong.

For instance: if you write Acentos não funcionam to a file and save it when you open it again it will read Acentos n達o funcionam.

Images Edited On Disk Don't Refresh

I created an image, used it on a slide, changed the picture, and the image in the slide never updates until I close and reopen the presentation.

Feature Request: Javascript for Viz (d3.js)

If you copy and paste this:

<!-- $theme: default -->

# Better Slides with Marp

<iframe src="http://koaning.io/theme/iframes/predict.html" height="300px" width="100%" frameBorder="0"></iframe>

### Vincent D.Warmerdam - @fishnets88 - koaning.io

---

Div below here.
<div id="viz"></div>
Above here. 

<script src="http://cdnjs.cloudflare.com/ajax/libs/d3/3.4.1/d3.min.js"></script>

<script type="text/javascript">

var sampleSVG = d3.select("#viz")
    .append("svg")
    .attr("width", 100)
    .attr("height", 100);    

sampleSVG.append("circle")
    .style("stroke", "gray")
    .style("fill", "white")
    .attr("r", 40)
    .attr("cx", 50)
    .attr("cy", 50)
    .on("mouseover", function(){d3.select(this).style("fill", "aliceblue");})
    .on("mouseout", function(){d3.select(this).style("fill", "white");});

</script>

You'll notice that the iframe loads splendidly (awesome!). This opens up the potential for truly interactive presentations, but it might be preferable to have the d3 visualisation live inside the slidedeck instead of having to use an iframe to access it. You'll notice that the second page containing the script tag and the custom javascript yields no results.

Is javascript turned off by default? Is this a possible feature?

Set max-height for images to 100%

I'm using some large images and it would be nice if they scaled down to fit inside the slide vertically.

Change the workflow to GitHub flow

I have surprised by many stars, issues, comments and PRs!!!!! ❤️
Thanks contributing to improve Marp.

---

Change the workflow

Currently, the latest branch is v0.0.9pre. I had developed smug branch rule. 😧
I want to merge it to master branch, to change the workflow to GitHub flow.

We would also merge submitted PRs according to a generally workflow.

Note: Change logs of v0.0.9pre

• Update Electron
  • Improve opening sequence of window
• Add footer directive (#2)
• Add prerender directive
• Background image support

speaker notes in presentation mode

As said in #13. It would be great to have speaker notes for presentations

Html style tag breaks current styling

Hi,
Adding an empty <style></style> tag to first line of Gaia theme example breaks center aligned tags.

I think adding html styles is a very important part of customizing presentations and it should be a first-class feature.

gaia.css reffer internet resources

gaia.css reffer internet resources as bellow.

@import url(https://fonts.googleapis.com/css?family=Lato:400,900);
@import url(https://fonts.googleapis.com/css?family=Roboto+Mono:400,700);

As a result, it takes time to generate the preview on enviroment can't connect internet.

Add support to Deckset files

Deckset is a paid app to write slides using markdown. I would like to render my deckset files using Marp.

The missing functionalities are:

Text

• #[fit] to make the text fit to the slide

Images

• ![fit] attribute to make images fit the slide
• Add filter to images when there is more content on screen, use ![original] to disable it
• ![original 250%] to zoom in
• ![left] and ![right] to align images
• ![filtered] to force the application of a filter on aligned images
• ![inline] to use inline images (current behavior)

Videos

• Inline videos
• Youtube Embedding
• left, right, fit, fill and percentage sizing
• autoplay, loop and mute

Presenter notes

• ^ creates presenter notes

Footer and slide numbers

• footer: My Footer directive on top of file
• slidenumbers: true directive on top of file

Links

• Ability to add link to other slides using <a>

Footnotes and named references

• [^1] to add footnotes
• [^Wiles, 1995] to add named references

TeX

• Use $$ delimiters to determine TeX formulas

Auto-scaling

• autoscale: true directive on top of file

Build steps

• build-lists: true directive on top of file

More information about each of this features can be seen on their cheat sheet

Emoji's not exported to PDF

Hi all

I just started using Marp and it's excellent - it's replaced PPT already.

I noticed that emoji's aren't exported to PDF though (i tried viewing in preview and Chrome) on both my OSX 10.9 and 10.11 installs. I don't think there's a generic issue with emoji's and PDF as e.g. this PDF has emoji's.

Happy to help/test/code in any way necessary if you're interested in supporting this.

Cheers
Neil

Backslashes render incorrectly in the CodeMirror editor

As discussed in #45, when I type a backslash \ in the editor it appears as a ¥ symbol - see the attached screenshot. This happens in the 0.0.8 binaries as well as the branch in the pull request.

On the top left is the ¥ symbol that appears, on the right is the rendered markdown slide showing the backslash correctly displayed. The file at the bottom shows the backslash is correctly saved to file.

Chocolatey

Nice project, I'm already using to post at my blog (hosted with Ghost CMS).

I think it's a good idea publish the project a Chocolatey, to easy install/updates at client side. Can we work with it?

Window is unable to show. Shows when selecting "Fullscreen". (0.0.8)

Unfortunately, I don't have steps to reproduce. It looks like the windows have disappeared somehow during my many switches between multi-monitor setups.

OS X El Capitan 10.11.5

Is there a persistent settings file for MARP?

Feature request: remote control with a phone

This could be done by running a local web server that is accessed from a phone and using websockets to push back and forward commands.

Feature Request: Latex (MathJax) support

blunt feature request

This app looks amazing but for my line of work it would be a requirement that i can also write maths in my slides. Luckily mathjax should solve this issue but it needs to get implemented. This project has the potential to replace deckset.

Cyrillic is behaving strangely in editor

Emoji isn't displayed on enviroment can't connect internet.

Emoji isn't displayed on enviroment can't connect internet.

Characters are changed when re open file

I write and save:
Diseño de aplicación.

When open I see:
Dise帽o de aplicaci贸n.

Feature request: support Incremental Slides syntax

ref to: remark Wiki, -- is used to make a slide increment to previous one.

BTW, the ??? syntax to add presentation notes is also a good idea. As remark.js has already been the best solution to convert markdown to html slides by now.

Support background changes to open files

Marp should poll the file being edited and check for concurrent edits.
If a concurrent change by another application is detected, it should at least a dialog asking the user if the content should be reloaded from file.

This would facilitate usage of other editors which might be better for certain editing tasks, like block editing.

Feature Request: Keyboard Shortcuts for Bold, Italic, etc.

It would be nice if CMD+B wrapped the selected text in ** ** (like in the Github editor). Would be great for italics (CMD+I) and any others you can think of.

Glitch while exporting PDF from markdown mode

You would see a part of slide glitch while exporting PDF from Markdown view mode.

Apply v0.0.9's new features in example.md

Marp v0.0.9 will support these new features:

• Background image: ![bg]()
• KaTeX support: $ and $$
• Footer support with <!-- footer: **** --> page directive
• Pre-render slide with <!-- prerender: true --> page directive

To ship it, we need to write these examples.

Feature Request: Math typesetting support

Would love to use this for talks/presentations that involve mathematics, without having to pre-render formulas and inject them as images.

I think the easiest way to accomplish them is by using MathJax, and having the Markdown processor emit it. Luckily, there appears to be a Markdown-it plugin for MathJax on npm: https://www.npmjs.com/package/markdown-it-mathjax

I think this should work fairly easily: just add this plugin and inject the MathJax JS on the rendered page.

How to start a presentation mode?

I can't find something in the UI to actually present the written slides.
How can I get into presentation mode?

Rather than that everything seems to be awesome ^_^

Feature Request: Vim style key-binding

It would be better if I could use Vim style key-binding.

broken img tag with relative path.

I'm using document directory outside of marp binaries.

![](images/my.png)

it works.

<img src="images/my.png" />

doesn't work.

when use full absolute path, img tag works.

Feature Request: Custom CSS

Having been frustrated with Deckset development, I was very happy to discover this project. One thing that I find particularly frustrating about Deckset is the inability to edit the CSS layout myself. Would love to have that available in Marp.

Command line

Hi everyone,

a friend told me about this project, and it seems really, really cool.

However, I am used to my custom editor, and I was wondering if there was a possibility to use this to generate pdf with a command line.

Is it already done ? Is it something you are intersted in ? And, maybe, can I help ?

Feature request: Twemoji support

Can you clarify how Twemoji is being supported in the examples rather than Appleʻs Emoji?

Thank you!

PDF Export doesn't honor style of theme

Reproduce:
Set theme on slides,
<!-- $theme: gaia -->
<!-- template: invert -->

Then export to PDF. The text color is light but the background is white, so in essence it's unreadable.

Marp won't open the editor/preview window - OSX 10.9

Hi (again)

I had a working OSX 10.9 install of Marp and created a couple of docs using it. The next day though (no reboot but i have tried a reboot since), i found Marp no longer opens the editor/preview window. The "About" dialogue opens and the main menu works.

Is there any debug/log info I can provide? I can't see anything but happy to help/investigate.

Cheers

Text encoding problems

Hello I found a bug in 0.0.8:

When storing a file containing Emojis they are not stored/loaded correctly: 😊👍 ends up in two cryptic letters when loading the file again.

Since the editor is able to handle full UTF-8 I would suggest to simply adjust the saving/loading methods to handle UTF-8 correctly.

I tested it on OS X (now called macOS) ;-)

Great project!!! Looking forward to updates.

Andreas

Feature Request: Presentation Mode

It would be great if I could present my presentation without the markdown showing and without having to export this to a file. Much like Powerpoint's presentation mode.

• Go full screen
• Support up/down left/right arrows and spacebar for navigating slides.
• Esc to quit and return to editing mode.

Feature Request: markdown view pdf export

Thank you for making a good program.

Please allow output to the screen that displays the mark-down view as a PDF. (not slide view)

Feature request: Make it possible to import new themes

At the moment this requires rebuilding the app. It would be great if I could make a theme for my university and upload it somewhere and people could just download and import it.

Feature request: Align right for images

Images can be set "center" to be centered. But for some logos on the first slide it would be great if also right alignment would be possible.

Feature Request: Footer

This is different from footnotes. A footer would be more like page numbers - something that appears on every slide in the presentation. In Deckset this is set with footer: but it could perhaps be set with HTML comments in MARP?

Sigining Developer ID certificate

We should sign Developer ID app certificate to avoid Gatekeeper.

Feature request: HTML export

It would be nice to be able to export the HTML of the presentation as well as the PDF.

Spectron tests

Wondering if a few end-to-end spectron tests would be a welcome PR.

Feature request: Save As/Publish to Speaker Deck

It would be awesome if Marp could publish directly to Speaker Deck, as opposed to exporting as PDF and then uploading to Speaker Deck manually.

Request: Marp for documents?

Marp is absolutely fantastic for slides. I was wondering, how hard would it be to modify Marp so that it could be used as a markdown document editor? Or do you know of a similar project that already exists?

I would like to be able to open and edit markdown documents, preview them live (as Marp does), export as PDF, and export as HTML - either converted to plain HTML, or linking to some Javascript to render within a browser.

The application is for editing classroom worksheets like this one

Currently we do this by editing the markdown in a text editor and then running it through pandoc. But this workflow does not give any live visual feedback from the editing process. It also requires pandoc to be installed where you are editing; and each time you make a change you have to re-run it and refresh in your browser to see what the rendered output looks like.

I think that unless you generate your rendered output from the same tool you are editing with, there's a risk that what you see is not what you get in the final output.

Hence a tool like Marp which both renders while editing and generates the final output is of great interest.

Support of auto line break on syntax highlighting

Now not be a new line at the time of the syntax highlighting.

example:

When a character does not fit on the screen,
I think that it should be a new line in the automatic.

Feature Request: Skipping Between Slides

I would like if I could press CmdOrCtrl+[ and CmdOrCtrl+] (or something) to skip to the previous/next instance of --- in the editor. That way I would be able to both skim through my presentation and edit it more conveniently.

I'd be willing to code this myself if you're open to taking PR's. I probably will, but it would be fun to give back as well :)

Feature Request: Ability Change Font Size of Text Editor

It would be great if we could change the font size or zoom into the text editor.

Thanks!