andreamussap / Axway_Docs4All_Hackathon

Repository for 'Docs as code' project developed by team Docs4All for the Axway Hackathon 2019

2 stars 21 forks source link

Convert HTML to kramdown Markdown #3

Open andreamussap opened 5 years ago

andreamussap commented 5 years ago

Description

We need a set of docs in markdown format for the hackathon project, so we can edit these docs in Netlifly CMS and on GitHub.

Convert 'API Gateway 7.7 Apache Cassandra Administrator Guide' to markdown

Tasks

[ ] Investigate/confirm that the markdown flavor must be kramdown to work with Jekyll.
[ ] Export Cassandra guide from Flare
[ ] Convert the files to markdown
[ ] Import files to this github repo

andreamussap commented 5 years ago

Task 1. Verify

Done.

If you’re using a static site generator, see the specific Markdown syntax used. With Jekyll, the default Markdown is kramdown. kramdown gives you more capabilities than the basic Markdown...

I didn't find a way to convert HTML directly to kramdown, so will convert it to GitHub-flavored Markdown instead.

"kramdown is largely compatible with GitHub-flavored Markdown"

Task 2. Export Cassandra Admin guide from Flare

Done.