diff --git a/experimental/README.md b/experimental/README.md new file mode 100644 index 0000000..8099470 --- /dev/null +++ b/experimental/README.md @@ -0,0 +1,44 @@ +# Experimental Stuff + +## Pandoc + +We can use Pandoc for: +- Initial conversion of the Word document +- Conversion of Markdown to other formats for publishing + +### Pandoc Installation +Install [pandoc](https://pandoc.org/installing.html). + +### Word to Markdown + +`pandoc NeTEx.docx -t gfm -o rg2.md --extract-media=media` + +Options: +- `-t gfm`: github type. See [Markdown Github Flavour Spec](https://github.github.com/gfm/). +- `-o rg2.md` the Markdown output file +- `extract-media=media`: extract media files to directory `media` + +#### Experimental Pandoc Examples + +| File | Type | Description | +|-----------------------------------|------|--------------------------------------------------------------------------------------------------------------------------| +| StopPlace-pandoc-gfm.md | `gfm` | Extract from markdown created with `pandoc NeTEx.docx -t gfm -o rg2.md --extract-media=media` | +| StopPlace-pandoc-gfm-corrected.md | `gfm` | Edited gfm example.