an R package which converts markdown files (.md, .Rmd) into mindmaps (brainstorms)
R
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
R Update foo.R Apr 17, 2018
inst v.1.1.0. update on CRAN Jul 19, 2017
man v.1.1.1 tribble dataframe Apr 17, 2018
showcase readme Jul 3, 2017
vignettes v.1.0.4. published on CRAN Jun 19, 2017
.Rbuildignore v.1.1.0. update on CRAN Jul 19, 2017
.gitattributes gitattributes Jul 20, 2017
.gitignore readme Jul 3, 2017
DESCRIPTION v.1.1.1 tribble dataframe Apr 17, 2018
LICENSE v.1.1.1 tribble dataframe Apr 17, 2018
NAMESPACE v1.1.1 Feb 19, 2018
mindr.Rproj start May 19, 2017
readme.md v.1.1.1 tribble dataframe Apr 17, 2018

readme.md

mindr: an R package that converts markdown (.md) or rmarkdown (.Rmd) files to mind maps, and vice versa

CRAN downloads

Introduction

With 'mindr' you can draw a mind map in markdown syntax, or start a markdown document from a mind map!

mindr is an R package which converts markdown (.md) or rmarkdown (.Rmd) files to mind maps (.mm), and vice versa. Mind map files (.mm) can be opened by or imported to common mindmap software such as the desktop software 'FreeMind'and 'XMind', or the online webware 'mindmeister'.

  • If your are a user of markdown or rmarkdown or bookdown or blogdown, mindr can convert your .md or .Rmd files into mind maps easily. Furthermore, you can write a new mind map with markdown syntax and use mindr to convert it into an .mm mind map.
  • If you are a mind map user, you can export your mind map into an .mm file and use mindr to convert it into a markdown file as an outline of your new document or book.

Quick start

Installation

# stable version:
install.packages("mindr")
# or development version:
devtools::install_github("pzhaonet/mindr")

Convert (a) markdown file(s) into a mindmap

Run:

library('mindr')
example(md2mm)

then you will get a demo mind map file mindr.mm in the working directory (getwd()). Open it with any mind-map (brainstorm) software, and you will get a mind map.

To create a mind map from your own markdown files, create a folder named mm in the working directory (getwd()), and drop some markdown or rmarkdown files into mm/. Run:

md2mm()

Plenty of cross-platform mindmap software suits are available (see the list), among which freemind and Xmind are highly recommended. If you would not like to install any of them, you could open the .mm file with the online webware 'mindmeister' in your web browser.

If you don't know what is markdown, here is a demo file.

Actually this is a new way to draw a mind map!

Convert (a) mind map(s) into a markdown file

Run:

library('mindr')
example(mm2md)

then you will get a demo markdown file mindr.mdin the working directory (getwd()).

To create a markdown file from your own mind map files, create a folder named mm in the working directory (getwd()), and drop some .mm files into mm/. Run:

mm2md()

Create Interactive Web MindMap with the JavaScript 'markmap' Library

Run:

example(markmap)

then you will see a demo interactive mind map in the viewer of your R session.

More themes can be seen if you run:

example(markmapOption)

To create your own interactive mind map, create a folder named mm in the working directory (getwd()), and drop some .mm files into mm/. Run:

markmap()

Extract the outline from (a) markdown files

Run:

library('mindr')
example(outline)

then you will get a demo outline file outline.md in the working directory (getwd()).

To extract the outline from your own markdown files, create a folder named mm in the working directory (getwd()), and drop some markdown or rmarkdown files into mm/. Run:

outline()

Convert a tibble dataframe column into amindmap

Run:

library('mindr')
example(tree2mm)

then you will get a demo outline file mindr.md in the working directory (getwd()).

Have fun!

Still being developed. Feel free to give your feedback to me!

Showcase

  • Mindmap of my book Learning R (in Chinese. to be published soon.)

Updates

  • 2018-04-17. v1.1.1. Support tribble dataframes.
  • 2017-07-19. v1.1.0. On CRAN. See CHANGES IN mindr VERSION 1.1.
  • 2017-07-05. v1.0.6. Rmarkmap added. Run example(markmap).
  • 2017-07-03. v1.0.5. Better backup.
  • 2017-06-19. v1.0.4. Released on CRAN!
  • 2017-06-02. v1.0.0. Backup existing files before overwritten. Submitted to CRAN.
  • 2017-05-21. v0.2.0. Rename functions.
  • 2017-05-21. v0.1.0. Bidirectional! Now mind maps can be converted to markdown.
  • 2017-05-20. v0.0.1. Can Save the outline.
  • 2017-05-19. v0.0.0. A very preliminary version.

License

Copyright 2017 Peng Zhao.

Released under the GPL license.