trello-to-markdown

Creates a folder structure reflecting lists in a trello board and adds the content description of the cards to it as markdown files

Usage no npm install needed!

<script type="module">
  import trelloToMarkdown from 'https://cdn.skypack.dev/trello-to-markdown';
</script>

README

trello-to-markdown

A node module to export a trello board, and convert it into a set of folders, and markdown files, corresponding to lists and cards on the board.

Used to convert textAV components board into gitbook.

Setup

npm install trello-to-markdown

Usage

const trelloToMarkdownFolders = require('trello-to-markdown');

const boardIdTextAVComponents = '58mo9Tpa';
trelloToMarkdownFolders({boardId: boardIdTextAVComponents, destFolderName: 'docs' );

Where destFolderName is just the name of the folder, not the path.

see example-usage.js

System Architecture

  • calls trello API with board id
  • get the lists in the boards
  • uses that to create the folder structure
  • second call to trello API gets the cards
  • iterate through the cards
    • and write description content of card as markdown file
    • in the folder corresponding to that card
  • Also creates as summary page
  • done

Development env

  • node
  • npm

Build

How to run build

No build steps

Tests

How to carry out tests

No automated tests for now, see example-usage.js to try it out locally

Deployment

to publish module to npm

npm run publish:public

<!--

TODO

  • add module.exports
  • move card id as param
  • figure out how to return a promise eg see dropbox paper to markdown Alvin PR
  • push to npm
  • new repo to get from tello textAV and create gitbook -->