This package provides the following services:
This package consumes the following services:
pulsar-ide-markdown
An IDE provider package for Markdown.
Taps into an installation of md-lsp
or Marksman — which you must install on your own. Follow the links for installation instructions.
Installation and Setup
- Install either Marksman or
md-lsp
. - Open the settings for this package.
- Choose one of the two options for “Language Server” — the one corresponding to whichever server you installed.
- Specify the path to the server in the appropriate setting — either “Path to Marksman” or “Path to md-lsp.” The default value may work if the binary is in your
PATH
; if you encounter an error on startup, you may instead want to specify the absolute path. - Integration into built-in packages (
autocomplete-plus
andsymbols-view
) will happen automatically. For other integrations, install some of the optional packages below.
Configuration
Marksman can be configured via a .marksman.toml
file (for per-project settings) or a global configuration file.
md-lsp
does not currently have any configuration system.
What does this package do?
Once your language server is installed and running, you may install any of the following packages to get special features, keeping in mind the following caveats:
- Features vary based on which server you’ve chosen.
- Not all of these have been extensively tested; file a bug if any don’t work as expected.
Start with these packages; they’re all builtin, actively maintained, and/or built exclusively for Pulsar:
- autocomplete-plus (builtin)
- Offers autocompletion of…
- heading anchors when writing links (within the same document and other documents in the project)
- footnote references
- Offers autocompletion of…
- symbols-view (builtin)
- View and filter a list of headings in the current file
- Jump to the document and heading referenced by an internal link (within the same document or between documents in the project)
- Jump between link/footnote references and their definitions
- linter and linter-ui-default
- View diagnostic messages
- intentions
- Code actions for creating/updating a table of contents in the current file (Marksman only)
- pulsar-find-references
- Highlight all links that reference a heading
- Highlight all link/footnote references that reference a definition
- pulsar-code-format
- Format the entire file or the selected text (
md-lsp
only)
- Format the entire file or the selected text (
- pulsar-outline-view
- View a hierarchical list of the file’s headings
- pulsar-refactor
- Rename headings, links, definitions, and footnotes while updating all associated references
- pulsar-hover
- See hover tooltips with contextual information (content varies between Marksman and
md-lsp
)
- See hover tooltips with contextual information (content varies between Marksman and
For other features that don’t have equivalents above, the legacy atom-ide
packages should also work:
- atom-ide-outline
- View a hierarchical list of the file’s headings
- atom-ide-code-format
- Format the entire file or the selected text (
md-lsp
only)
- Format the entire file or the selected text (
- atom-ide-definitions
- Jump to the definition of the symbol under the cursor