lalalic / docx2html

a converter from docx to html
334 stars 86 forks source link

docx2html

docx2html is a javascript converter from docx to html on nodejs and browser. here's a demo.

installation

npm install docx2html

example

const docx2html=require("docx2html")
docx2html(input.files[0])
/** you can do further with utilities in converted html
    .then(html=>{
        //html.toString()
        //html.asZip/download/save
    })
*/

api

License

MIT, and I also provide commercial support for tickets and enhancement to pay my rent.

Feature

It is based on docx4js 1.x to parse docx, and utilize docx4js api to traverse docx models and convert docx models to html elements.

Ideally, each docx model should have a specific converter to create accordingly html elements, so the design is simply to map from type of docx model to html element constructor.

While, the difficulty is that some docx models are difficult to be expressed in html. It's luckly that we have CSS3 that make some rich styles possible in html, such as numbering, all(12) kinds of table styles.

Word shape utilizes SVG to draw lines, rects, and etc, but so far it only supports limited shapes, while the left job is time.

P of html, according to HTML specification, is restricted not to include any block container, such as div, so there's no p tag, but all div with paragraph styles, and then do some arrangement when dom is ready with a small javascript code.

It keeps header and footer for every section, but there's no conditional consideration, such as odd and even header/footer.

Word Field is kept, while so far only link is supported.

environment

model

style

ToDo