Skip to content
Copymarky

FAQ & Troubleshooting

General Questions

Section titled “General Questions”

What is Copymarky?

Section titled “What is Copymarky?”

Copymarky is a browser extension that converts web pages into clean, well-formatted Markdown with a single click. Just select content or click the extension icon, and get Markdown ready to paste into your notes, docs, or knowledge base.

Supported browsers: Chrome, Chromium, Firefox, and other WebExtension-compatible browsers.

Nothing happens when I click the extension icon

Section titled “Nothing happens when I click the extension icon”

Diagnosis: The extension may not be running or properly installed.

Solutions:

  1. Check if extension is installed and enabled:

    • Open your browser’s extensions menu
    • Search for “Copymarky”
    • Ensure it shows as enabled (toggle on)
    • If not installed, visit the Chrome Web Store or Firefox Add-ons to install it

  2. Reload the page:

    • Press F5 or Cmd+R (Mac) to refresh the page
    • Click the extension icon again

  3. Check browser console for errors:

  4. Restart your browser:

    • Close all browser windows and reopen

Is Copymarky free? Does it collect my data?

Section titled “Is Copymarky free? Does it collect my data?”

Yes, Copymarky is free and open-source. No data is sent anywhere—the extension runs entirely in your browser. All conversion and settings are stored locally on your device.

Privacy: See Getting Started for more details.

Formatting Issues

Section titled “Formatting Issues”

My copied Markdown has weird formatting, extra spaces, or strange characters

Section titled “My copied Markdown has weird formatting, extra spaces, or strange characters”

Cause: The HTML structure of the page may have unusual formatting, or your settings don’t match the desired output.

Solutions:

  1. Check your Format settings:

    • Open the Copymarky popup or sidepanel
    • Go to the Format tab
    • Verify that Heading Style, Bullet Marker, Code Block Style, and Link Style match your preferences
    • Try different combinations and re-copy to test

  2. Adjust heading style:

    • Switch between ATX (#) and Setext (underline) styles
    • Some pages render better with one style over the other

  3. Use text replacements to clean up:

    • Go to the Replace tab
    • Add post-replacement rules to normalize formatting (e.g., remove extra whitespace)
    • See Text Replacements Guide for practical examples

  4. Enable/disable page title and source URL:

    • Go to the Output tab
    • Toggle Include Page Title and Include Source URL to reduce clutter
Section titled “Images or links are missing from the copied Markdown”

Cause: The output settings may be filtering them, or the elements weren’t detected properly.

Solutions:

  1. Check Output settings:

    • Open the Copymarky popup/sidepanel → Output tab
    • Image Handling: Set to Keep images (not “Skip”)
    • Link Style: Choose Inlined or Referenced
    • Save and re-copy

  2. Use the Element Picker (if selecting content):

    • Click the picker icon in the popup
    • Hover over content to highlight what will be copied
    • Click to copy only highlighted elements
    • See Using Copymarky for details

  3. Check if elements are marked as non-content:

    • Some sites use CSS to mark certain elements as navigational or ads
    • Copymarky may skip these intentionally
    • Try copying a larger area or the entire page

  4. Verify images are hosted publicly:

    • Markdown images reference URLs, not embedded data
    • If images are internal or require authentication, they won’t display in the Markdown

Heading styles don’t look right in my note app

Section titled “Heading styles don’t look right in my note app”

Cause: Your note app may have different rendering rules for ATX vs. Setext styles.

Solution:

  1. Try the other heading style:

    • Open Copymarky → Format tab
    • Switch Heading Style between ATX (#) and Setext (underline)
    • Re-copy and paste into your app

  2. Check your note app’s Markdown documentation:

    • Some apps prefer one style over the other
    • Your app might render them differently

Text Replacements

Section titled “Text Replacements”

My regex replacement is not working

Section titled “My regex replacement is not working”

Cause: Regex syntax error, scope mismatch, or the rule is disabled.

Solutions:

  1. Verify regex syntax:

    • Test your pattern on regex101.com
    • Make sure the JavaScript flavor is selected
    • Check for unescaped special characters (\, [, (, etc.)

  2. Check the rule is enabled:

    • Go to Replace tab
    • Ensure the rule has a blue enabled toggle
    • Ensure the parent phase (Pre/Post) is also enabled

  3. Remember: Pre applies to HTML, Post applies to Markdown:

    • Pre-replacements run on HTML before conversion
    • Post-replacements run on Markdown after conversion
    • The same pattern may not work in both phases
    • Example: <div> tags only exist in pre (HTML); Markdown code fences only exist in post

  4. Verify the scope matches your action:

    • Go to Replace tab → select the rule
    • Check scope: Should match what you’re copying (all/selection/page/link)
    • “all” = apply to everything
    • “selection” = only when you copy selected text
    • “page” = only when you copy the whole page
    • “link” = only when copying from a link

  5. Test with a simpler regex:

    • Disable complex rules and test one at a time
    • Start with a literal (non-regex) rule to isolate the issue

Example: If you want to remove [Advertisement] blocks:

Pattern: \[Advertisement\]
Replacement: (empty)
useRegex: true

How do I reset my text replacements to defaults?

Section titled “How do I reset my text replacements to defaults?”

Option 1: Delete rules individually

  • Open the Replace tab
  • Click the delete (trash) icon on each rule

Option 2: Export a clean config and re-import

  • Export your current settings: Replace tab → Export button
  • Delete the textReplacements section from the JSON file
  • Re-import the cleaned file: Replace tab → Import button

Note: Copymarky has no built-in “reset all” button, but these methods are quick.

Settings & Configuration

Section titled “Settings & Configuration”

How do I reset all settings to defaults?

Section titled “How do I reset all settings to defaults?”

Method 1: Clear extension data

  • Open your browser’s Settings → Privacy or Extensions
  • Find Copymarky, click Details/Options
  • Click Clear data or Reset
  • Copymarky will use defaults on next use

Method 2: Export a clean config

  • If you want to keep some settings, export first, then delete settings you want to reset
  • Re-import the cleaned JSON file

See: Import & Export for detailed steps.

How do I share settings with my team?

Section titled “How do I share settings with my team?”

Solution: Export and import settings.

  1. Person A exports settings:

    • Open Copymarky popup/sidepanel → Replace tab
    • Click Export button
    • Save the copymarky-settings.json file

  2. Share the file with team members via email, Slack, Drive, etc.

  3. Person B imports settings:

    • Open Copymarky popup/sidepanel → Replace tab
    • Click Import button
    • Select the copymarky-settings.json file
    • Settings are merged into their existing configuration

Tip: You can edit the JSON file to standardize rules across the team before sharing.

See: Import & Export for more details.

Is my data synced across devices?

Section titled “Is my data synced across devices?”

Currently: No automatic cross-device sync.

Workaround: Use Export/Import to backup and restore settings on another device.

  1. Device A: Export settings → Save file to cloud storage (Google Drive, Dropbox, etc.)
  2. Device B: Download file from cloud → Import in Copymarky

Future: Cross-device sync may be added in a future release. Follow GitHub issues for updates.

Website & Content-Specific Issues

Section titled “Website & Content-Specific Issues”

Can I use Copymarky on [specific site]?

Section titled “Can I use Copymarky on [specific site]?”

Short answer: Copymarky works on any website that renders HTML in your browser.

Caveat: If content is loaded dynamically (JavaScript), you may need to refresh first.

If content is being skipped:

  1. Ensure the page is fully loaded:

    • Wait a moment for JavaScript to finish loading
    • Refresh the page and try again
    • Check if content appears in your browser view

  2. Use the Element Picker:

    • Click the picker icon in Copymarky popup
    • Hover over desired content to preview what will be copied
    • Click to copy only that section
    • See Using Copymarky

  3. Check if elements are marked as navigation or ads:

    • Some websites use CSS classes that mark elements as non-content
    • Copymarky intentionally skips these
    • Try copying a broader section or the entire page

  4. Report issues:

The Markdown output is too cluttered with unwanted content

Section titled “The Markdown output is too cluttered with unwanted content”

Solution: Use text replacements to filter out unwanted content.

  1. Identify the pattern:

    • Open the copied Markdown in a text editor
    • Look for repeated phrases, patterns, or placeholders

  2. Create a pre-replacement rule (for HTML cleanup):

    • Open Copymarky → Replace tab
    • Click Add Rule under “Pre-replacements”
    • Enter the pattern (literal or regex)
    • Leave replacement empty to delete
    • Save and re-copy

  3. Or create a post-replacement rule (for Markdown cleanup):

    • Similar to above, but add under “Post-replacements”
    • Use Markdown-specific patterns

Example: Remove [Click here] buttons from all content:

Pattern: \[Click here\]
Replacement: (leave empty)
useRegex: false
Scope: all

See: Text Replacements Guide for more examples.

Bugs & Support

Section titled “Bugs & Support”

Where can I report bugs or request features?

Section titled “Where can I report bugs or request features?”

GitHub Issues: https://github.com/grikomsn/copymarky/issues

When reporting, include:

  • Your browser and version (e.g., Chrome 131)
  • The website where you encountered the issue (if applicable)
  • Steps to reproduce
  • What you expected vs. what actually happened
  • Screenshots or the problematic Markdown output (if helpful)

The extension crashes or shows an error

Section titled “The extension crashes or shows an error”

Steps:

  1. Open the browser console (F12 → Console tab)
  2. Reproduce the error
  3. Copy any red error messages
  4. Open a GitHub issue at https://github.com/grikomsn/copymarky/issues
  5. Paste the error and describe what you were doing

Temporary workaround: Disable/re-enable the extension:

  • Browser menu → Extensions → Find Copymarky → Toggle off then on

Tips & Tricks

Section titled “Tips & Tricks”

How do I preview what will be copied before copying?

Section titled “How do I preview what will be copied before copying?”

Use the Element Picker:

  1. Click the picker icon in the Copymarky popup
  2. Hover over elements on the page
  3. A highlight shows what will be copied
  4. Click to copy that section
  5. Click outside to cancel

See: Using Copymarky for detailed walkthrough.

Can I copy only a selection instead of the whole page?

Section titled “Can I copy only a selection instead of the whole page?”

Yes! Copymarky adapts to your context:

  • Highlight some text on the page → Text replacement rules with scope: "selection" apply
  • Click extension icon without selection → scope: "page" rules apply (or “all”)
  • Right-click a link → scope: "link" rules apply (if supported)

See Using Copymarky for more context-specific features.

How do I know if Copymarky is working?

Section titled “How do I know if Copymarky is working?”

Quick test:

  1. Visit any website (e.g., Wikipedia)
  2. Click the Copymarky extension icon
  3. The markdown is automatically copied to your clipboard
  4. Paste it into a text editor or note app
  5. You should see clean, formatted Markdown

If nothing appears, see Nothing happens when I click the extension icon above.

Need More Help?

Section titled “Need More Help?”

Still stuck? Open an issue with as much context as you can provide, and the community will help!