Package Control

The Sublime Text package directory, re-imagined.

Markdown Formatting

Mouse-first Markdown formatting for Sublime Text: configurable context menus, profiles and a styled picker.

OctSepAugJulJunMayAprMarFebJan Dec2025 Nov 2026-W47 | installs: 24 | removals: 2 | upgrades: 0 2026-W47 | installs: 24 | removals: 2 | upgrades: 0 2026-W47 | installs: 24 | removals: 2 | upgrades: 0 01020 WeeklyInstalls 024 WeeklyUpgrades 2026-W46 1.1.0 / 1.0.1 / ... 1.1.0 / 1.0.1 / 1.0.0
Installations: 24 in total
Installations minus removals
Upgrades

Links

Versions

1.1.0 (ST4215+) ·
2026-11-15 21:57

More
  • (ST4215+) 1.0.1 ·
    2026-11-15 12:42
  • 1.0.0 ·
    2026-11-13 19:53

Markdown Formatting for Sublime Text

Select text. Right-click. Markdown Formatting → Bold, a heading, a list, or another format. No shortcuts to memorize and no external tools to install.

Requires Sublime Text 4 and is tested with build 4215.

Install

Package Control: open the Command Palette, run Package Control: Install Package and choose Markdown Formatting. Updates install automatically.

Manually:

  1. Download Markdown Formatting.sublime-package from the package website or this repository's dist/ directory. Keep that exact filename.
  2. In Sublime Text, choose Preferences → Browse Packages….
  3. Go up one directory and open Installed Packages. Create it if absent.
  4. Copy the archive there without unzipping it, then restart Sublime Text.

Then open a .md file (syntax: Markdown), select text, and right-click.

Windows data is normally under %APPDATA%/Sublime Text, macOS under ~/Library/Application Support/Sublime Text, Linux under ~/.config/sublime-text. Browse Packages also works for portable/custom installations and is the preferred way to locate the right data directory.

Update a manual install by replacing that same archive and restarting. Uninstall by removing it (or with Package Control: Remove Package); optionally remove Packages/User/Markdown Formatting.sublime-settings. No generated menus or extra packages are left behind.

Everyday formatting

The menu follows the active Markdown profile. GFM is the default; CommonMark and MultiMarkdown are available. CriticMarkup review actions are enabled by default in a separate Review group; they are an annotation extension, not GitHub Flavored Markdown. Set enable_critic_markup to false to disable them. Existing explicit false overrides remain respected on update. On Windows, Sublime may leave an empty submenu heading when all its actions are hidden; hover-to-open menus are preserved. See the native-menu limitation. This is a source-editing helper, not a full Markdown parser or renderer.

Choose your menu

Open Preferences → Package Settings → Markdown Formatting → Settings or run Preferences: Markdown Formatting Settings from the Command Palette.

{
    "profile": "gfm",
    "hidden_actions": ["image", "insertion"],
    "labels": {"bold": "Strong emphasis"},
    "picker_order": ["bold", "italic", "heading_2"],
    "custom_formats": [
        {"label": "Highlight (HTML)", "prefix": "<mark>",
         "suffix": "</mark>", "placeholder": "highlighted text"}
    ]
}

Hide/show built-ins and rename them in both native menu and pickers. The native menu retains a compact, predictable grouping. picker_order reorders the pickers, not native menu groups.

The Styled Picker follows your active color scheme automatically. Each clickable row is just a syntax-highlighted example: # Heading 1, **Bold**, or [Link](https://example.com). The action name becomes the example text; there is no separate label followed by text. Punctuation and text use Sublime's Markdown highlighting, including your installed Markdown syntax. Open pickers refresh when theme/color-scheme settings change; reopening also uses the current appearance. No manual styles configuration is needed.

Sublime's native context menu still uses normal native captions and does not expose per-item colors/fonts. This package never modifies your color scheme, document, selection or undo history just to display a preview. Legacy styles and custom-format color values are ignored by the Styled Picker.

The searchable chooser is accessible from the same menu and command palette. Custom templates are available through Custom Formats… and both pickers. No default key bindings are installed. Example bindings, all settings, project overrides and custom formats: configuration guide.

Scope and safety

Right-click menu

The Markdown Formatting submenu only shows formatting actions in Markdown files, and show_in_context_menu: false removes them everywhere. Sublime Text on Windows and macOS still draws the submenu heading, with Settings… inside, because it can't hide submenu headings there.

To remove the submenu completely, or to keep only the actions you use, replace the package's menu file with your own:

  1. Choose Preferences → Browse Packages… and create a folder named Markdown Formatting there.
  2. In that folder, create a file named Context.sublime-menu.
  3. To remove the submenu, put [] in the file. To customize it, copy the original menu into the file and delete the entries you don't want.

Your file replaces the package's menu until you delete it. After an update, compare it with the original menu if you want new actions.

Development

python3 scripts/build_package.py
python3 scripts/check.py

build_package.py writes dist/Markdown Formatting.sublime-package; check.py runs the tests and fails if that file is out of date. See development and architecture.

MIT licensed; see LICENSE.

Results

Packages