Skip to content

A markdown outline sidebar plugin for Joplin.

License

Notifications You must be signed in to change notification settings

jerrylususu/joplin-outline

 
 

Repository files navigation

Joplin Outline Plugin

This is a outline plugin for Joplin. Refer to joplin toc.

English · 简体中文


screenshot

Features

  • Support atx-style headers (#), not setext-style headers (---, ===).
  • Support right click to paste markdown inner link.
  • Support custom style.
  • Support adding custom symbols before headings.
  • Support jumping to header in Editor Mode. (contributed by @jerrylususu)

Requirements

  • Joplin 1.3.15 or higher for application plugins support.

Installation

To install joplin-outline, copy outline.jpl to your profile's plugins directory. The outline will be automatically loaded and executed when you restart the application.

Configurations

Configuration Type Description
Toggle Shortcut String Shortcut to switch panel display
Auto Hide Bool Automatically hide the panel when there is no content
Font Family String Default: var(--joplin-font-family)
Font Size (pt) Int Default: 10pt
Font Color String Default: var(--joplin-color)
Background Color String Default: var(--joplin-background-color)
Disable Linewrap Bool Disable the linewrap
Number Style String
H[1-6] Prefix String Custom prefix

Building

Building the plugin

The plugin is built using Webpack, which creates the compiled code in /dist. A JPL archive will also be created at the root, which can use to distribute the plugin.

To build the plugin, simply run npm run dist.

The project is setup to use TypeScript, although you can change the configuration to use plain JavaScript.

Updating the plugin framework

To update the plugin framework, run yo joplin --update

Keep in mind that doing so will overwrite all the framework-related files outside of the "src/" directory (your source code will not be touched). So if you have modified any of the framework-related files, such as package.json or .gitignore, make sure your code is under version control so that you can check the diff and re-apply your changes.

For that reason, it's generally best not to change any of the framework files or to do so in a way that minimises the number of changes. For example, if you want to modify the Webpack config, create a new separate JavaScript file and include it in webpack.config.js. That way, when you update, you only have to restore the line that include your file.

Community

A markdown outline sidebar plugin for Joplin

Toc as the sidebar

About

A markdown outline sidebar plugin for Joplin.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 72.3%
  • JavaScript 26.1%
  • CSS 1.6%