Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shd101wyy/crossnote
Powerful markdown tool
https://github.com/shd101wyy/crossnote
markdown
Last synced: 7 days ago
JSON representation
Powerful markdown tool
- Host: GitHub
- URL: https://github.com/shd101wyy/crossnote
- Owner: shd101wyy
- License: other
- Created: 2017-07-10T22:33:25.000Z (over 7 years ago)
- Default Branch: develop
- Last Pushed: 2024-09-07T13:55:58.000Z (2 months ago)
- Last Synced: 2024-10-31T17:55:57.795Z (12 days ago)
- Topics: markdown
- Language: JavaScript
- Homepage:
- Size: 120 MB
- Stars: 496
- Watchers: 12
- Forks: 126
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- jimsghstars - shd101wyy/crossnote - Powerful markdown tool (JavaScript)
README
# Crossnote `[WIP]`
Also called as `mume` before.
[](https://www.npmjs.com/package/crossnote)
[](https://www.npmjs.com/package/crossnote)
[](https://www.npmjs.com/package/crossnote)
This library powers:
- [markdown preview enhanced for vscode](https://github.com/shd101wyy/vscode-markdown-preview-enhanced)
API Documentation: https://shd101wyy.github.io/crossnote/
## Installation
```sh
# If you are using npm
$ npm install --save crossnote
# If you are using yarn
$ yarn add crossnote
```
## Example
```javascript
// CJS
const { Notebook } = require('crossnote');
// ESM
// import { Notebook } from "crossnote"
async function main() {
const notebook = await Notebook.init({
notebookPath: '/absolute/path/to/your/notebook',
config: {
previewTheme: 'github-light.css',
mathRenderingOption: 'KaTeX',
codeBlockTheme: 'github.css',
printBackground: true,
enableScriptExecution: true, // <= For running code chunks.
},
});
// Get the markdown engine for a specific note file in your notebook.
const engine = notebook.getNoteMarkdownEngine('README.md');
// open in browser
await engine.openInBrowser({ runAllCodeChunks: true });
// html export
await engine.htmlExport({ offline: false, runAllCodeChunks: true });
// chrome (puppeteer) export
await engine.chromeExport({ fileType: 'pdf', runAllCodeChunks: true }); // fileType = 'pdf'|'png'|'jpeg'
// prince export
await engine.princeExport({ runAllCodeChunks: true });
// ebook export
await engine.eBookExport({ fileType: 'epub' }); // fileType = 'epub'|'pdf'|'mobi'|'html'
// pandoc export
await engine.pandocExport({ runAllCodeChunks: true });
// markdown(gfm) export
await engine.markdownExport({ runAllCodeChunks: true });
return process.exit();
}
main();
```
## Notebook Configuration
[Visit here to see the documentation.](https://shd101wyy.github.io/crossnote/interfaces/NotebookConfig.html)
```js
const config = {
// File of extensions to be included in the notebook
markdownFileExtensions: [".md", ".markdown", ".mdown", ".mkdn", ".mkd", ".rmd", ".qmd", ".mdx"],
// The content to be included in HTML `` tag.
// This is useful for adding custom styles or scripts.
includeInHeader: "",
// Enable this option will render markdown by pandoc instead of markdown-it.
usePandocParser: false,
// In Markdown, a single newline character doesn't cause a line break in the generated HTML. In GitHub Flavored Markdown, that is not true. Enable this config option to insert line breaks in rendered HTML for single newlines in Markdown source.
breakOnSingleNewLine: true,
// Whether to enable preview zen mode.
// Enable this option will hide unnecessary UI elements in preview unless your mouse is over it.
enablePreviewZenMode: boolean;
// Enable smartypants and other sweet transforms.
enableTypographer: false,
// Enable conversion of URL-like text to links in the markdown preview.
enableLinkify: true,
// Math
mathRenderingOption: "KaTeX", // "KaTeX" | "MathJax" | "None"
mathInlineDelimiters: [["$", "$"], ["\\(", "\\)"]],
mathBlockDelimiters: [["$$", "$$"], ["\\[", "\\]"]],
mathRenderingOnLineService: "https://latex.codecogs.com/gif.latex", // "https://latex.codecogs.com/svg.latex", "https://latex.codecogs.com/png.latex"
mathjaxV3ScriptSrc: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js',
// Enable Wiki Link syntax support. More information can be found a https://help.github.com/articles/adding-links-to-wikis/
enableWikiLinkSyntax: true,
// If checked, we use GitHub style piped wiki links, i.e. [[linkText|wikiLink]]. Otherwise, we use
// [[wikiLink|linkText]] as the original Wikipedia style.
useGitHubStylePipedLink: true
// Enable emoji & font-awesome plugin. This only works for markdown-it parser, but not pandoc parser.
enableEmojiSyntax: true
// Enable extended table syntax to support merging table cells.
enableExtendedTableSyntax: false
// Enable CriticMarkup syntax. Only works with markdown-it parser.
// Please check http://criticmarkup.com/users-guide.php for more information.
enableCriticMarkupSyntax: false
// Front matter rendering option
frontMatterRenderingOption: 'none', // 'none' | 'table' | 'code block'
// Mermaid theme
mermaidTheme: 'default', // 'default' | 'dark' | 'forest'
// Code Block theme
// If `auto.css` is chosen, then the code block theme that best matches the current preview theme will be picked.
codeBlockTheme: 'auto.css',
// "auto.css",
// "default.css",
// "atom-dark.css",
// "atom-light.css",
// "atom-material.css",
// "coy.css",
// "darcula.css",
// "dark.css",
// "funky.css",
// "github.css",
// "github-dark.css"
// "hopscotch.css",
// "monokai.css",
// "okaidia.css",
// "one-dark.css",
// "one-light.css",
// "pen-paper-coffee.css",
// "pojoaque.css",
// "solarized-dark.css",
// "solarized-light.css",
// "twilight.css",
// "vue.css",
// "vs.css",
// "xonokai.css"
// Preview theme
previewTheme: 'github-light.css',
// "atom-dark.css",
// "atom-light.css",
// "atom-material.css",
// "github-dark.css",
// "github-light.css",
// "gothic.css",
// "medium.css",
// "monokai.css",
// "newsprint.css",
// "night.css",
// "none.css",
// "one-dark.css",
// "one-light.css",
// "solarized-dark.css",
// "solarized-light.css",
// "vue.css"
// Revealjs presentation theme
revealjsTheme: "white.css",
// "beige.css",
// "black.css",
// "blood.css",
// "league.css",
// "moon.css",
// "night.css",
// "serif.css",
// "simple.css",
// "sky.css",
// "solarized.css",
// "white.css",
// "none.css"
// Accepted protocols for links.
protocolsWhiteList: "http://, https://, atom://, file://, mailto:, tel:",
// When using Image Helper to copy images, by default images will be copied to root image folder path '/assets'
imageFolderPath: '/assets',
// Whether to print background for file export or not. If set to `false`, then `github-light` preview theme will b used. You can also set `print_background` in front-matter for individual files.
printBackground: false,
// Chrome executable path, which is used for Puppeteer export. Leaving it empty means the path will be found automatically.
chromePath: '',
// ImageMagick command line path. Should be either `magick` or `convert`. Leaving it empty means the path will be found automatically.
imageMagickPath: '',
// Pandoc executable path
pandocPath: 'pandoc',
// Pandoc markdown flavor
pandocMarkdownFlavor: "markdown-raw_tex+tex_math_single_backslash",
// Pandoc arguments e.g. ['--smart', '--filter=/bin/exe']. Please use long argument names.
pandocArguments: [],
// Default latex engine for Pandoc export and latex code chunk.
latexEngine: 'pdflatex',
// Enables executing code chunks and importing javascript files.
// This enables also the sidebar table of content.
// ⚠ ️ Please use this feature with caution because it may put your security at risk!
// Your machine can get hacked if someone makes you open a markdown with malicious code while script execution is enabled.
enableScriptExecution: false,
// Enables transform audio video link to to html5 embed audio video tags.
// Internally it enables markdown-it-html5-embed plugins.
enableHTML5Embed: false,
// Enables video/audio embed with ![]() syntax (default).
HTML5EmbedUseImageSyntax: true,
// Enables video/audio embed with []() syntax.
HTML5EmbedUseLinkSyntax: false,
// When true embed media with http:// schema in URLs. When false ignore and don't embed them.
HTML5EmbedIsAllowedHttp: false,
// HTML attributes to pass to audio tags.
HTML5EmbedAudioAttributes: 'controls preload="metadata" width="320"',
// HTML attributes to pass to video tags.
HTML5EmbedVideoAttributes: 'controls preload="metadata" width="320" height="240"',
// Puppeteer waits for a certain timeout in milliseconds before the document export.
puppeteerWaitForTimeout: 0,
// Args passed to puppeteer.launch({args: $puppeteerArgs})
puppeteerArgs: [],
// Render using PlantUML server instead of binary. Leave it empty to use the plantuml.jar file at `plantumlJarPath` (`java` is required in system path). Eg: "http://localhost:8080/svg/".
// You run start a plantuml server by running:
// $ docker run -d -p 8080:8080 plantuml/plantuml-server:jetty
plantumlServer: "http://localhost:8080/svg/",
// The absolute of the PlantUML jar file.
// The plantuml.jar file could be downloaded from https://sourceforge.net/projects/plantuml/
plantumlJarPath: "",
// Example values:
// - cdn.jsdelivr.net
// - fastly.jsdelivr.net
// - gcore.jsdelivr.net
// - testingcf.jsdelivr.net
jsdelivrCdnHost: "cdn.jsdelivr.net",
// Kroki server url.
krokiServer: "https://kroki.io",
// Always show backlinks in the preview.
alwaysShowBacklinksInPreview: false,
}
```
## Notebook Local Configuration
If your notebook has `.crossnote` directory, then when you run `await Notebook.init`, it will automatically create several configuration files in `.crossnote` directory and load the configurations.
```
.crossnote
├── config.js
├── head.html
├── parser.js
└── style.less
```
## Development
1. Clone this project.
2. Run `yarn install` from shell.
3. Run `yarn build:watch` to start the watch mode.
4. Run `yarn build` to build the project.
Or
If you already have [nix](https://nixos.org/download.html) and [direnv](https://direnv.net/) installed, simply cd to the project directory, then run `direnv allow` once.
## License
[University of Illinois/NCSA Open Source License](LICENSE.md)