Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions experimental/README.md
Original file line number Diff line number Diff line change
@@ -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.<br/><ul><li>Tables in Markdown<li>Links to anchors |
| StopPlace-pandoc-markdown.md | `markdown` | Extract from markdown created with `pandoc NeTEx.docx -t markdown -o rg2.md --extract-media=media` |
| StopPlace-pandoc-markdown2.md | `markdown` | See Markdown Method 2

**Markdown Method 2**

``` shell
pandoc NeTEx.docx from=docx
--to=markdown+pipe_tables+grid_tables+multiline_tables+table_captions+definition_lists+footnotes+tex_math_dollars+smart-auto_identifiers
--markdown-headings=atx
--wrap=none
--eol=lf
--extract-media=x
--reference-link
--reference-location=document
--track-changes=accept
-o output.md
```

Loading