dfinke / vscode-pandoc

Visual Studio Code extension lets you render markdown to pdf, word doc or html with pandoc
124 stars 36 forks source link

Preview does not handle Pandoc specfic dialect of markdown #15

Open 8 opened 7 years ago

8 commented 7 years ago

Hi,

first off: thank you for your work on this extension!

I am currently trying to find a happy path for markdown editing which will be rendered with pandoc and I came upon your extension and gave it a try.

I've chosen pandoc because it allows converting between multiple formats, most notably html and docx which makes creating otherwise cumbersome formats a breeze.

Pandoc makes writing documents enjoyable by using and extending the markdown syntax as published by daringfireball. For example it adds 'implicit_header_refererences', which makes it painless to link to a header without clutter.

For example the following code produces a list of items, where the first item links to Header1 and the second item links to Header2:

List of items:

- [Header1] 
- [Header2]

## Header1

## Header2

Other important features would be 'example_lists' and 'simple_tables'.

You can find Pandoc's Markdown explained here.

The preview panes of most markdown editors only support the base markdown specification, which make them useless if you're using pandoc, so I was looking for an editor that is able to handle pandocs markdown and preview those extensions correctly.

As this extension was built specifically with pandoc in mind, I was hoping that it would support the pandoc markdown syntax.

Take care,
Martin

dfinke commented 7 years ago

Thanks for the info. This extension vs code extension works with the markdown file you're viewing. I haven't tried yet, but I think if you have pandoc markdown in your file it should render,

This extension does not to the preview rendering in the vs code editor. That is an interesting idea and the last release of vs code, the notes said the separated out the markdown previewer. Maybe it can be wired up and pandoc rendering can be inserted.