one2html
| Crates.io | one2html |
| lib.rs | one2html |
| version | 1.3.0 |
| created_at | 2020-11-09 09:10:22.25122+00 |
| updated_at | 2025-12-30 13:00:17.225445+00 |
| description | Convert Microsoft OneNote® notebooks to HTML |
| homepage | |
| repository | https://github.com/msiemens/one2html |
| max_upload_size | |
| id | 310233 |
| size | 200,398 |
Markus Siemens (msiemens)
documentation
README
one2html
one2html lets you convert OneNote® files (sections or whole notebooks) into HTML.
Installation
Choose one of the following installation options:
-
Download from GitHub Releases.
-
Install via
cargo binstall:
cargo binstall one2html
- Build from source:
cargo install --locked --no-default-features one2html
All options require the latest stable Rust compiler.
If you are using a nightly compiler, you can omit the
--no-default-features flag to print stack traces when errors occur during
OneNote file parsing.
Usage
Download OneNote files from OneDrive
OneNote files can be retrieved using one of two methods: Either by
using onedrive-cli or by downloading a notebook via the OneDrive web UI.
To do this first install onedrive-cli following its instructions. After
logging in using onedrive-cli login, you can download a section (a single
.one file), or a notebook (a folder that contains a .onetoc2 file along
with other .one files):
# Download a notebook
onedrive-cli ls Documents/
onedrive-cli cp -R :/Documents/Notebook .
# Download a section
onedrive-cli cp -R :/Documents/Notebook/Section.one .
Alternatively, to download OneNote notebooks via the OneDrive web UI, follow these steps:
- Visit https://onedrive.live.com
- Select the folder that contains your notebooks. Typically this is the Documents folder.
- Use the Download button from the toolbar to download a ZIP file that contains all of your OneNote notebooks.
Convert OneNote files to HTML
OneNote sections are stored in .one files. To convert a section
to HTML run:
one2html -i Section.one -o ./output_dir/
OneNote notebooks are stored as folders that contain a .onetoc2
file along with the notebook's sections stored as .one files.
To convert a notebook to HTML run:
one2html -i 'Notebook/Open Notebook.onetoc2' -o ./output_dir/
Limitations
- Due to limitations of the OneNote parser only files downloaded from OneDrive are supported. This means you can't convert files created by the OneNote 2016 desktop application using this tool.
Disclaimer
This project is neither related to nor endorsed by Microsoft in any way. The author does not have any affiliation with Microsoft.