Formats and compatibility
carta names formats the way pandoc does, so a command written for one runs against the other. A
format name may carry extension toggles (markdown+hard_line_breaks-raw_html), and
carta --list-extensions=<format> prints the set a given format accepts.
Formats
Section titled “Formats”Markdown family
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| CommonMark | commonmark | Usable | Usable | read-commonmark write-commonmark |
| CommonMark-X | commonmark_x | Usable | Usable | read-commonmark write-markdown |
| Djot | djot | Not started | Not started | — |
| GitHub-Flavored Markdown | gfm | Usable | Usable | read-commonmark write-gfm |
| Pandoc Markdown | markdown | Usable | Usable | read-commonmark write-markdown |
| GitHub Markdown, legacy | markdown_github | Usable | Usable | read-commonmark write-markdown |
| MultiMarkdown | markdown_mmd | Usable | Usable | read-commonmark write-markdown |
| PHP Markdown Extra | markdown_phpextra | Usable | Usable | read-commonmark write-markdown |
| Markdown strict | markdown_strict | Usable | Usable | read-commonmark write-markdown |
| Markua | markua | Not applicable | Not started | — |
HTML & slides
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| Beamer | beamer | Not applicable | Usable | write-beamer |
| Chunked HTML | chunkedhtml | Not applicable | Not started | — |
| DZSlides | dzslides | Not applicable | Not started | — |
| HTML | html html5 | Usable | Usable | read-html write-html |
| HTML 4 | html4 | Not applicable | Usable | write-html4 |
| PowerPoint | pptx | Not started | Not started | — |
| reveal.js | revealjs | Not applicable | Usable | write-revealjs |
| S5 | s5 | Not applicable | Not started | — |
| Slideous | slideous | Not applicable | Not started | — |
| Slidy | slidy | Not applicable | Not started | — |
TeX & typesetting
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| ConTeXt | context | Not applicable | Not started | — |
| LaTeX | latex | Usable | Usable | read-latex write-latex |
pdf | Not applicable | Not started | — | |
| Texinfo | texinfo | Not applicable | Not started | — |
| Typst | typst | Not started | Usable | write-typst |
Lightweight markup
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| AsciiDoc | asciidoc | Not started | Usable | write-asciidoc |
| AsciiDoc legacy | asciidoc_legacy | Not applicable | Not started | — |
| Asciidoctor | asciidoctor | Not applicable | Not started | — |
| Haddock | haddock | Not started | Not started | — |
| Muse | muse | Not started | Not started | — |
| Org mode | org | Usable | Usable | read-org write-org |
| Perl POD | pod | Not started | Not applicable | — |
| reStructuredText | rst | Usable | Usable | read-rst write-rst |
| txt2tags | t2t | Not started | Not applicable | — |
| Textile | textile | Not started | Not started | — |
Wikis
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| Creole | creole | Not started | Not applicable | — |
| DokuWiki | dokuwiki | Usable | Usable | read-dokuwiki write-dokuwiki |
| Jira | jira | Usable | Usable | read-jira write-jira |
| MediaWiki | mediawiki | Usable | Usable | read-mediawiki write-mediawiki |
| TikiWiki | tikiwiki | Not started | Not applicable | — |
| TWiki | twiki | Not started | Not applicable | — |
| Vimwiki | vimwiki | Not started | Not applicable | — |
| XWiki | xwiki | Not applicable | Not started | — |
| ZimWiki | zimwiki | Not applicable | Not started | — |
roff
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| man | man | Usable | Usable | read-man write-man |
| mdoc | mdoc | Not started | Not applicable | — |
| ms | ms | Not applicable | Not started | — |
| vimdoc | vimdoc | Not applicable | Not started | — |
Word processor, ebook & notebook
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| Word | docx | Usable | Usable | read-docx write-docx |
| EPUB | epub epub2 epub3 | Usable | Usable | read-epub write-epub |
| FictionBook2 | fb2 | Not started | Not started | — |
| InDesign ICML | icml | Not applicable | Not started | — |
| Jupyter Notebook | ipynb | Usable | Usable | read-ipynb write-ipynb |
| OpenDocument Text | odt | Usable | Usable | read-odt write-odt |
| OpenDocument | opendocument | Not applicable | Not started | — |
| Rich Text Format | rtf | Usable | Usable | read-rtf write-rtf |
| Spreadsheet | xlsx | Not started | Not applicable | — |
XML & publishing
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| BITS | bits | Not started | Not applicable | — |
| DocBook | docbook docbook4 docbook5 | Not started | Not started | — |
| JATS | jats jats_archiving jats_articleauthoring jats_publishing | Not started | Not started | — |
| TEI | tei | Not applicable | Not started | — |
| Generic XML | xml | Not started | Not started | — |
Bibliography
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| BibLaTeX | biblatex | Not started | Not started | — |
| BibTeX | bibtex | Not started | Not started | — |
| CSL JSON | csljson | Not started | Not started | — |
| EndNote XML | endnotexml | Not started | Not applicable | — |
| RIS | ris | Not started | Not applicable | — |
Data, interchange & terminal
| Format | Names | Reader | Writer | Cargo features |
|---|---|---|---|---|
| ANSI terminal | ansi | Not applicable | Not started | — |
| BBCode | bbcode bbcode_fluxbb bbcode_hubzilla bbcode_phpbb bbcode_steam bbcode_xenforo | Not applicable | Not started | — |
| CSV | csv | Usable | Not applicable | read-csv |
| Pandoc JSON | json | Usable | Usable | read-json write-json |
| Native Pandoc AST | native | Usable | Usable | read-native write-native |
| OPML | opml | Usable | Usable | read-opml write-opml |
| Plain text | plain | Not applicable | Usable | write-plain |
| TSV | tsv | Usable | Not applicable | read-tsv |
Extensions
Section titled “Extensions”Supported
smartstrikeoutsuperscriptsubscriptpipe_tablesfootnotestask_listsautolink_bare_uristex_math_dollarsfenced_divsbracketed_spanshard_line_breaksraw_htmlheader_attributesfenced_code_attributesinline_code_attributeslink_attributesattributesdefinition_listsgrid_tablesmultiline_tablessimple_tablestable_captionsline_blocksfancy_listsexample_listsstartnumyaml_metadata_blockpandoc_title_blockauto_identifiersgfm_auto_identifiersimplicit_header_referencesimplicit_figuresraw_attributeinline_notesnative_divsnative_spansmarkdown_in_html_blocksraw_texcitationstable_attributesblank_before_blockquoteblank_before_headermarkemojialertstex_math_single_backslashtex_math_double_backslashlists_without_preceding_blanklineintraword_underscoresbacktick_code_blocksfenced_code_blocksescaped_line_breaksspace_in_atx_headerall_symbols_escapablespaced_reference_linksshort_subsuperscriptsmmd_title_blockmmd_header_identifiersabbreviationsmarkdown_attribute
Recognized, behavior not yet modeled
These names are already recognized internally, but the reader does not yet branch on the construct:
latex_macroswikilinks_title_after_pipewikilinks_title_before_pipeascii_identifiersmmd_link_attributesold_dasheseast_asian_line_breaksfour_space_ruleliterate_haskellrebase_relative_pathsgutenbergangle_brackets_escapableignore_line_breaksraw_markdown
